This guide provides step-by-step instructions for creating an Okta app integration using OpenID Connect (OIDC) for a web application. This is a one-time setup process to enable secure authentication with Numero. Follow these steps in the Okta Admin Console.
Step 1: Log In to Okta Admin Console
Navigate to your Okta organization’s sign-in page and log in using your administrator credentials.
Step 2: Access the Applications Section
Once logged in, your dashboard will appear.
Navigate to Applications in the left sidebar.
3. Click Create App Integration to start setting up your new integration.
Step 3: Select Sign-In Method and Application Type
In the pop-up box, select OIDC - OpenID Connect as the Sign-in method.
2. Select Web Application as the Application type.
3. Click Next.
Step 4: Configure General Settings
Provide a suitable name for the App integration (e.g., "Numero").
Under Core grants, select Refresh Token (this generates a token valid for 2 days for security purposes).
Under Other grants, select Implicit (hybrid).
Step 5: Set Up URIs and Access Controls
Select Allow wildcard * in sign-in URI redirect.
Note: Ignore any pop-up warning about potential security risks—there is no actual risk for this setup.
2. In the Sign-in redirect URIs field, enter: https://app.numero.io/auth/callback/okta
Filling in Sign-out redirect URIs and Base URIs is optional.
3. Under Assignments, set Controlled access according to your preference (e.g., Allow everyone in your organization to access).
If selecting "Allow everyone," unselect Enable immediate access with Federation Broker Mode when it appears.
4. Click Save to create the integration.
After saving, you’ll be redirected to the new integration’s details page, where you can view and edit the setup.
Step 6: Edit General Settings
Click Edit next to General Settings.
2. Scroll to the Advanced dropdown and expand it.
3. Select Allow Access Token with implicit grant type and click Save.
Step 7: Configure Login Settings
Under the Login section, set Login initiated by to Either Okta or App.
For Application visibility, select Display application icon to users.
3. For Login flow, select Redirect to app to initiate login (OIDC Compliant).
4. In the Initiate login URI field, enter: https://app.numero.io/auth/callback/okta
Step 8: Verify the Integration
After saving, scroll down to the Embed Link section.
Confirm that an Embed Link has been generated—this verifies the integration setup.
The app will appear on the dashboard for users who have been granted access, depending on the admin’s assignment settings.
Next Step: Share Configuration Details
After completing the setup in Okta, please share the following details with the Numero team to enable authorization for your integration:
Client ID
Client Secret
Embed Link
These credentials allow us to securely connect and authorize your organization’s access to the Numero integration.