What it provides
- User sync — Active and deactivated users; feeds the access-review and provisioning controls
- Per-user MFA enrollment — Feeds the authentication control
- Group memberships and assigned applications — Feeds the least-privilege control
Setup
1
Sign in to your Okta admin console
Use a service-account user with a read-only admin role for least privilege.
2
Open Security → API → Tokens
Navigate to the API tokens section in your Okta admin console.
3
Create a token
Click Create Token and name it something descriptive like Regentra Compliance.
4
Copy the token immediately
Okta will not show the token again after this screen.
5
Enter credentials in Regentra
In Regentra, go to Settings → Integrations → Okta. Paste the token and your Okta domain (e.g.
mycompany.okta.com). Save and test the connection.Sync frequency
- Identity sync (users, MFA enrollment, group/app assignments) runs every 4 hours on the hour
- System log poll (sign-in events, factor activity) runs hourly at
:30— aligned with the Duo auth-log poll to spread load - Manual sync can be triggered at any time from the integration card
Frequently asked questions
What permissions does the API token need?
What permissions does the API token need?
Read-only is enough. Okta API tokens inherit the role of the user that created them. Best practice: create the token from a service-account user with a read-only admin role (e.g. Read-only administrator), so the token can never modify users, MFA factors, or apps even if it leaks.
Tokens expire — what happens?
Tokens expire — what happens?
Okta API tokens are valid until used at least once every 30 days, or rotated by an admin. Regentra’s identity sync runs every 4 hours, so tokens stay alive automatically as long as syncs keep succeeding. If you rotate manually, paste the new token; the old one stops working immediately.
Should I use Okta API tokens or OAuth?
Should I use Okta API tokens or OAuth?
API token for now. OAuth-based service-to-service is on the roadmap but not required for evidence sync.