This guide explains how to integrate your Emburse Cards and Okta accounts to enable user provisioning with the SCIM protocol. To learn more about SCIM and Okta, see this page.
Supported Features
The Emburse Cards Okta app will allow admins to automatically create, edit, and deactivate Emburse Cards users based on their organization's Okta member directory. In addition, the Emburse Cards app enables Single-Sign On (SSO).
Requirements
To enable integration between Emburse Cards and Okta you must be signed in as an admin in both accounts.
Configuration Steps
1. In your Okta admin dashboard, go to the settings page for the Emburse Cards application. In the "Provisioning" tab, click on "API Integration", then click the "Configure API Integration" button.
2. Check the box next to "Enable API Integration", and then click "Authenticate with Emburse Cards".
3. A new window will appear asking you to authorize Okta to manage users in your Emburse Cards account. Click "Authorize Application".
4. You should be taken back to the Okta dashboard, and you should see a message stating that "Emburse Cards was verified successfully!". Click "Save".
5. In the Settings sidebar, click on "To App", then in the main panel click "Edit" Check the "Enable" boxes for "Create Users", "Update User Attributes", and "Deactivate Users". Click "Save".
6. In the "Sign On" tab, set the 'Application username format' to 'Email'. Click "Save".
Your Okta account is now configured to sync your user directory to your Emburse Cards organization.
Syncing Okta users to Emburse Cards
1. In the Emburse Cards application in your Okta dashboard, click on the "Assignments" tab, and click on the "Assign" button in the upper left. If you would like to create Emburse Cards accounts for individual users, click "Assign to People". If you would like to create emburse accounts for larger groups of users, click "Assign to Groups".
2. Choose the users or groups you would like to create Emburse Cards accounts for, and click "Assign". In the information dialog that appears, make sure that the "User Name" and "Primary Email" are the same value. Emburse Cards requires members to use email addresses to log in, so it is not possible to have different values for these fields. Once you click "Save and Go Back", these users will be immediately created as members in your Emburse Cards organization.
Troubleshooting and Tips
- Once an Emburse Cards user is created it is not possible to change their username. If you sync a user from your Okta account to your Emburse Cards account and then try to change the username for that account, you will receive an error.
- For other issues or questions regarding Emburse Cards, email us directly at support@emburse.com.