Skip to content
English
Contact us
  • There are no suggestions because the search field is empty.

Configure SCIM for Azure

In this article, you’ll learn how to configure SCIM for Azure. Configuring SCIM for Azure allows you to use Okta to manage users in Wellness Coach.

Configuring SCIM

After you have configured your SSO settings for Azure, you are now ready to configure SCIM. To configure SCIM for Azure, follow the steps below:

1. Go to Azure admin console and click on Azure Active Directory

554c21ea-1755-4c11-b806-958478d56f58

2. On left panel, select “Enterprise Application”

97792afe-4c95-475c-9158-c25e305a9545

3. Find Wellness Coach Application (WC-SSO)

d7101669-5bdf-4c43-a343-4ff85e5e04d6

4. Select “Provisioning” on the left hand side menu and Click on Get Started

5a56dd40-3c31-4e5c-84ca-f3feaafd25d1

5. Complete the steps below


    1. From dropdown select “Automatic”

    2. Enter “Tenant URL” → “https://ed.wellnesscoach.live/scim”

    3. Enter the secret token(Copy your SCIM token from portal account settings or please ask Wellness Coach team for the Token and proceed)

Click on “Test Connection”

ac25bab5-4d30-4ec7-88b3-74415e2a6931

6. Go back to the “provisioning” tab and select “Start Provisioning.”

3aa3d008-4fb4-4010-add1-a11e1dca18d1

Default Mappings

The default field mappings are shown below:

 
 

Default Azure Active Directory Attribute

Attribute

Wellness Coach Field

userPrincipalName

userName

Email

givenName

name.givenName

First Name

surname

name.familyName

Last Name

employeeId

urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber

Employee Number

jobTitle

title

Job Title

department

urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department

Department

manager

urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager.value

Note:For manager information to sync, the applicable managers must be included in the sync.

Manager Email
 

Note:The Division and Organization fields are unmapped by default. If you plan to use these fields, you'll need to add the mapping. You can add these attributes by following the instructions in the Adding Attribute Mapping for Custom User Fields section below.

Changing the Default Mappings

You can change the default mappings to customize the user information that syncs between Microsoft Entra and Wellness Coach.

To change the default mappings, follow the steps below:

  1. From your Microsoft Entra ID, navigate to Enterprise applications.

  2. Select the application you created for your KnowBe4 connection.

  3. From the menu on the left side of the page, select Provisioning.

c75f27dc-2623-4aac-b1a1-c7dceb08f6c7

4. Click the Mappings drop-down arrow to expand the Mappings tab.

9b18a718-0937-4a5a-a8b3-a10059bd0784

5. Click Provision Azure Active Directory Users.

6. Scroll down to the Attribute Mappings section. From this section, you'll see a list of all the attributes that have been mapped. The Azure Active Directory Attribute column displays the name of the attribute in Microsoft Entra. The customappsso Attribute column displays the SCIM standard name for this attribute.

29d0a468-f35f-4a86-bea2-b3f7240a46f0

7. Select the attribute you would like to edit.


8. In the Edit Attribute side pane, customize the attribute. For details about the customization options, see the list below:


    1. Mapping type: Select Direct from the drop-down menu.

    2. Source attribute: Select the Azure field that you want to map to this custom field.

    3. Default value if null: This field is optional, and we recommend that you leave it blank.

    4. Target attribute: Select the custom field that you want to map to the Azure field you selected.

    5. Match objects using this attribute: We recommend you select No.

    6. Apply this mapping: We recommend you select Always.

9. Once you have made the changes you would like to make, click Ok.


 

0a06af29-655b-478e-a085-938bd86269c1

Adding Attribute Mapping for Custom User Fields

You also have the option to custom fields. These fields are not mapped by default, but you can add them to Microsoft Entra by following the steps below:

  1. From your Microsoft Entra ID, navigate to Enterprise applications.

  2. Select the application you created Wellness Coach connection.

  3. From the menu on the left side of the page, select Provisioning.

  4. Click the Mappings drop-down arrow to expand the Mappings tab.

    3958dd3d-68b5-4812-ba3d-eece8b5ea54a (1)

5. Click Provision Azure Active Directory Users.

6. Click Add New Mapping at the bottom of the table.

7. From the Edit Attribute window, select the Source attribute you would like to use.

8. Then, select the Target Attribute that you would like to use. To view the supported custome attribute please visit this link.