Getting Started with Just Auth

Welcome to Just Auth! This guide will walk you through the initial setup process to get your organization up and running with our platform. We'll cover the following steps:

1. Setting up Authentication
2. Integrating with Your Ticketing System
3. Enabling Integrations
4. Activating Audit Mode

1. Setting up Authentication

Just Auth offers two options for authentication: OIDC and built-in OAuth. Choose the method that best fits your organization's needs.

Option A: Using Built-in OAuth (default)

1. Navigate to the Settings page.
2. Scroll to the "Authentication" section.
3. Select "Built-in OAuth" as your authentication method.
4. Your primary domain was automatically configured when you signed up. However, on this page, you can:
5. Change your primary domain
6. Add additional domains for authentication
7. Enter any new domains you want to add for authentication (e.g., yourcompany.com).
8. Click "Save Changes" to update your domain settings and enable built-in OAuth for the specified domains.

Note

Changing your primary domain or adding new ones will affect user authentication, so make sure to update any relevant configurations in your application.

Option B: Setting up OIDC

1. Navigate to the Settings page.
2. Scroll to the "Authentication" section.
3. Select "OIDC" as your authentication method.
4. Enter your OIDC provider details, including the client ID, client secret, and authorization endpoints.
5. Click "Save Changes" to apply your OIDC configuration.

2. Integrating with Your Ticketing System

1. Go to the Ticketing page.
2. Select your ticketing system from the list of supported integrations (e.g., Jira, ServiceNow, GitHub Issues).
3. Follow the prompts to authenticate and authorize Just Auth to access your ticketing system.

3. Enabling Integrations

Just Auth offers several integrations to cover different data access flows within your organization. To enable these integrations:

1. Navigate to the Integrations page.
2. You'll see a list of available integrations. Currently, these include:

a. Chrome Browser Extension b. Reverse Proxy c. Forward Proxy d. CLI (Command Line Interface)

1. For each integration you want to enable: a. Click on the integration. b. Follow the prompts to set up and configure the integration. c. For the Chrome Browser Extension:

   • Install the extension from the Chrome Web Store.
   • Configure it to align with your organization's policies. d. For the Reverse Proxy and Forward Proxy:
   • Choose between our hosted version or self-hosting options.
   • Follow the setup instructions for your chosen deployment method. e. For the CLI:
   • Download and install the CLI tool.
   • Configure it for your specific use cases (e.g., Docker images, SSH sessions).

2. After setting up each integration, click "Enable Integration" to activate it.

Note

Keep an eye out for upcoming integrations, including SQL Integration and AI Chat Proxy, which will expand Just Auth's capabilities in the future.

For more detailed information on each integration, please refer to their respective documentation pages in the Integrations section.

4. Activating Audit Mode

1. Stay on the Settings page.
2. Scroll to the "Audit Mode" section.
3. Toggle the "Enable Audit Mode" switch to the ON position.
4. Configure audit settings, such as log retention period and audit log destinations.
5. Click "Save Audit Settings" to apply your configuration.

Congratulations! You've now completed the initial setup of Just Auth for your organization. The system will begin cataloging your organization's access paths, allowing you to gain insights into your data access patterns and enforce justified access policies.

Next Steps: - Review the Policies documentation to learn how to create custom access control policies. - Explore the Resources page to understand how to organize and protect your data access points. - Contact our support team if you need any assistance or have questions about your setup.