Background
Ten Thousand Coffees (10KC) is an enterprise software platform for mentoring, networking and informal talent development experiences used by the world’s top organizations.
10KC’s SCIM v2.0 integration streamlines and automates adding, updating, and deleting member profiles.
Integration Setup
1. Configure SCIM server
Ten Thousand Coffees authenticates via a Bearer Token passed in the HTTP authorization header. We will share an Endpoint and Bearer Token with you via email.
2. Decide on user profile attributes
None of the fields below are required except for First Name, Last Name, and Email Address. The remaining fields in the list are recommended, and we explain why below, along with data spec requirements.
Field name |
Why we recommend |
Column Heading Override XML Alias |
Data spec requirements |
First Name* |
* We require this field to invite members to your 10KC hub. |
first_name |
Can be any alpha-numeric string. |
Last Name* |
* We require this field to invite members to your 10KC hub. |
last_name |
Can be any alpha-numeric string. |
Email Address* |
* We require this field to invite members to your 10KC hub. |
|
Can be any alpha-numeric string. |
Employee ID |
To rectify reporting issues if a member changes their email address. |
employee_id |
Can be any alpha-numeric string. |
Program Eligibility |
So we only invite eligible participants.
We can also potentially use one of the other fields in this list, such as “Business Unit”. |
program_eligibility |
We expect the values “eligible” or “ineligible” |
Status |
To de-activate profiles for employees that are on leave. |
status |
We expect the values “active” or “inactive”. They are case-sensitive. |
Job Function, Job Family, or Management Level |
For creating relevant matches by keeping these attributes in sync with your HRIS or Identity Management Software.
|
job_function |
Can be any alpha-numeric string. Ideally it’s easy for members to read and understand. |
Hire Start Date |
For creating relevant matches by keeping these attributes in sync with your HRIS or Identity Management Software.
|
hire_start_date |
We expect the format MM/DD/YYYY. |
Business Unit, Supervisor Organization, or Department |
For creating relevant matches by keeping these attributes in sync with your HRIS or Identity Management Software.
|
business_unit |
Can be any alpha-numeric string. Ideally it’s easy for members to read and understand. |
Office Location |
For creating relevant matches by keeping these attributes in sync with your HRIS or Identity Management Software.
|
office_location |
Can be any alpha-numeric string. |
People Manager Status |
For creating relevant matches by keeping these attributes in sync with your HRIS or Identity Management Software.
|
people_manager_status |
We expect “yes” or “no”. |
High Potential Status |
For creating relevant matches by keeping these attributes in sync with your HRIS or Identity Management Software.
|
high_potential_status |
We expect “yes” or “no”. |
Diversity dimensions
(e.g. gender)
|
For creating relevant matches by keeping these attributes in sync with your HRIS or Identity Management Software.
|
gender |
Can be any alpha-numeric string. |
First Level Supervisor |
To provide reporting for 3-4 levels under the CEO |
first_level_supervisor |
Can be any alpha-numeric string. Ideally it’s easy for members to read and understand. |
Second Level Supervisor |
To provide reporting for 3-4 levels under the CEO |
second_level_supervisor |
Can be any alpha-numeric string. Ideally it’s easy for members to read and understand. |
Third Level Supervisor |
To provide reporting for 3-4 levels under the CEO |
third_level_supervisor |
Can be any alpha-numeric string. Ideally it’s easy for members to read and understand. |
Locale |
To automatically localize 10KC in the user’s preference (if the preferred language is available) |
locale |
We currently only support two values:
• “fr-CA” for French(Canada)
• “en-US” for English(US)
Note: any blank values will be set as “en-US” |
Most Recent Role Start Date |
To enable mobility analyses |
most_recent_role_start_date |
We expect the format MM/DD/YYYY |
Role Reason Change Code |
To enable mobility analyses |
role_reason_change_code |
Can be any alpha-numeric string. |
3. Assign users to 10KC
In your SCIM server, assign users and groups to the 10KC application. To unlock retention and career mobility insights, we recommend allowing all members of your organization the option to join 10KC.
Security Considerations
Security Measures
10KC has strict security policies and we follow all best practices like annual pen-testing, annual internal audit, third party SOC2 audit and aligning with regional data privacy requirements.
Ten Thousand Coffees uses WorkOS to enable Okta SCIM v2.0 connections for our enterprise customers. WorkOS is SOC 2 Type certified, GDPR and CCPA compliant, and performs annual 3rd-party security penetration tests, as well as external code audits. More detailed documentation on their security practices can be found here.
Comments
0 comments
Please sign in to leave a comment.