Manage Users with Okta SCIM
    • 19 Jul 2024
    • 2 Minutes to read
    • Dark
      Light
    • PDF

    Manage Users with Okta SCIM

    • Dark
      Light
    • PDF

    Article summary

    With Okta SCIM, Admins can automate their entire user's lifecycle in Dialpad — from creating accounts to profile updates, to account deletion.

    In this article, we'll dive into Okta SCIM and show you step-by-step instructions on how to set up automatic provisioning.

    Let's dive into the details. 


    If you haven't already, take a look at our help article on downloading Dialpad in Okta and setting up SSO via SAML.

    Who can use this feature
    Dialpad's Okta SCIM integration is available on our Dialpad Ai Voice, Contact Center, and Sales plans.

    Enable API access

    To enable API access, you must have Super Admin or Company Admin access to your company's Dialpad account.

    First, you'll need to configure and enable the API integration between Dialpad + Okta.

    1. Navigate to your Dialpad app in Okta
    2. Select Provisioning
    3. Navigate to API Integration
    4. Select Configure API Integration
    5. Check the box beside Enable API Integration

    Once you've checked this option, you'll need to provide Okta with a new Dialpad API Token.

    Once you've entered your API token, select Test API Credentials to ensure everything is syncing before selecting Save.

    Screen_Shot_2022-05-09_at_8.01.25_AM.png

    Provisioning to app (Dialpad) 

    Once your API is configured and synced, the next step is enabling the provisioning from Okta into Dialpad, like creating users, updating user info, or even deleting users.

    Here's how: 

    1. Select Edit
    2. Check the fields you want to enable (in our case, all)
    3. Select Save

    Screen_Shot_2022-05-09_at_8.02.27_AM.png

     Assign to users 

    Now that you've turned on provisioning, you'll need to assign your Dialpad app to your users. Here's how:

    1. Navigate to the Assignments tab
    2. Select Assign
    3. Select People
    4. Select Assign next to the individuals

    You'll be prompted to review their username (it should be their email) and other profile details. If everything looks good, select Save and Go Back to return to the assignment page.

    Screen_Shot_2022-05-09_at_8.03.25_AM.png

    You can also assign groups to an app, if you've already created groups of users within Okta.

    Once you've done this, your users will automatically be created in Dialpad, and a number will be auto-assigned based on the area code of the office you set up.

    Okta attributes mapped to Dialpad

    Let's dive into what Okta attributes are mapped to Dialpad.

    Okta Attribute

    Mapped Dialpad Field

    Notes

    First Name

    Name

    First ame and Last Name combined

    Last Name

    Name

    First Name and Last Name combined

    Username

    Email

    The user's handle@domain

    department

    Office



    officeName

    Office

    Custom attribute (not available in Okta by default)

    countryCode

    Country



    preferredLanguage

    Language



    title

    Job Title

     

    licenseType

    License

    Custom attribute (not available in Okta by default).
    The data type for this field should be String

    Values can be any from the table below.


    License 

    Product

    dialpad_talk

    Ai Voice

    dialpad_lite

    Ai Voice(Lite)

    dialpad_support

    Ai Contact Center

    dialpad_sell

    Ai Sales

    dialpad_tfb

    Dialpad TfB Offer


    Tip
    If you’re creating custom attributes, make sure that the external namespace is urn:ietf:params:scim:schemas:extension:enterprise:2.0:User 

    Frequently asked questions 

    When someone is removed from Dialpad via Okta, do they still appear in the Dialpad team list?

    When you remove someone from the Dialpad app via Okta, the user will be suspended in Dialpad and no longer use a user license. While the user won't appear in your team list, you can still search for the user and verify their status is Suspended.

    When you delete a user from Okta, the user is suspended from Dialpad, but they remain searchable.  

    Can I change a number or extension in OKTA SCIM?

    No, these changes need to be made on our Admin portal. Check out our Number Assignment articles for more details. 



    Was this article helpful?