Provisioning Webex with PingOne
Webex supports user lifecycle and access management through PingOne provisioning. By using the Webex connection in PingOne, you can provision users, groups, and memberships between Webex and PingOne.
Provisioning capabilities
The following table summarizes the inbound and outbound provisioning capabilities for each resource type:
| Resource | Capability | Description | Inbound | Outbound |
|---|---|---|---|---|
User |
Create |
Generates a new user record in the destination. |
Yes |
Yes |
Read |
Retrieves or polls user attributes for synchronization. |
Yes |
Yes |
|
Update |
Modifies existing attributes, such as |
Yes |
Yes |
|
Delete |
Deletes a user or temporarily suspends an account. |
Yes |
Yes |
|
Group |
Create |
Provisions a new group in the target application. |
No |
Yes |
Rename |
Updates the display name or identifier of an existing group. |
No |
Yes |
|
Delete |
Removes a group from the target application. |
No |
Yes |
|
Membership |
Add and remove |
Adds or removes users from groups. |
No |
Yes |
Before you begin
Make sure that you have:
-
A Webex account. Learn more in Getting started with Webex in the Webex documentation.
-
The following from your Webex account:
-
Client ID
-
Client Secret
-
Token Endpoint
-
Grant Type
-
Refresh Token
-
-
Users created and assigned to a group specifically for Webex provisioning in PingOne. Learn more in Adding a user in PingOne and Managing groups.
Steps
-
Create a Webex connection:
-
In the PingOne admin console, go to Integrations > Provisioning.
-
Click the Plus icon and then click New Connection.
-
Click Select for Identity Store.
-
Click Select for the Webex connection, and click Next.
-
Enter a Name and Description for the connection.
-
Click Next.
-
In the Configure Authentication section, enter the following configurations that apply to your Webex account:
-
Service URI: Enter the base URL for the Webex API endpoint, such as
https://webexapis.com/v1. -
Authentication Method: Select either of the following:
-
OAUTH: Enter the following:
Field Example Client ID
C5692ab0958b1f3aebca1ed31161876e49a37323dac6df0cd12a181059ba86b66Client Secret
e457b25f5005042bc1b985decda36c8fc30765d92d81ef2ef9ad70637f976303Token Endpoint
https://webexapis.com/v1/access_tokenGrant Type
refresh_tokenRefresh Token
RzY3ZDNkYmUtMDAyNy00OGNiLWJmODYtMzE0ZWVjMDVhYTY0Y2IxMGZhNDMtOTY3_P0A1_ccbad3e7-d2d0-4a39-ab94-8770a15d2dbf -
TOKEN: Enter the Bearer Token, such as
MjQ5NGYzOWEtZTkzMy00MzhlLWE0NzItNDhjNThmYTJhYzE5ZjdmMmRiNmQtYzcz_P0A1_ccbad3e7-d2d0-4a39-ab94-8770a15d2dbf.
-
-
-
Click Next.
-
In the User Actions section, enter the following as needed:
Field Description Enable users creation
Creates a user in the target identity store when the user is created in the source identity store.
Enable users updation
Updates user attributes in the target identity store when the user is updated in the source identity store.
Enable users deprovision
Deprovisions a user in the target identity store when the user is deprovisioned in the source identity store. If Enable users deprovision is selected, the following options appear:
-
Remove Action: To remove a user in the target identity store when the user is deleted in the source identity store, select Delete.
-
Deprovision on rule deletion: Deprovisions users if the associated provisioning rule is deleted.
-
-
Click Save.
-
To enable the connection, click the toggle at the top of the details panel to the right (blue).
You can disable the connection by clicking the toggle to the left (gray).
-
-
Create an inbound or outbound rule and select the existing Webex connection as the target or source. You can optionally add attribute mappings.
Use the following inbound mapping examples for the Webex rule configuration:
Webex PingOne Directory emailsEmail AddresslastNameFamily NamefirstNameGiven NameemailsUsernameUse the following outbound mapping examples for the Webex rule configuration:
PingOne Directory Webex UsernamedisplayNameEmail AddressemailsGiven NamefirstNameManager NameManagerFamily NamelastNameManagerIDManager ID
Validation
-
View the sync status to confirm users and groups are successfully provisioned to Webex and to check for errors.
-
Review sync summary examples to help interpret your results.
Webex directory attributes
The following table lists common Webex attributes that can be mapped for user provisioning:
| PingOne Attribute | Description |
|---|---|
|
The display name for the Webex user. |
|
The user email attribute used for synchronization and matching. |
|
The user’s given name. |
|
The user’s family name. |
|
The manager name-value used in outbound mapping. |
|
The manager identifier value used in outbound mapping. |