Use JumpCloud SAML Single Sign On (SSO) to give your users convenient but secure access to all their web applications with a single set of credentials. Automatically provision, update and deprovision users in Calendly from JumpCloud using the Identity Management (SCIM) integration. Leverage this integration to centralize user lifecycle, identity, and access management in JumpCloud for Calendly. Save time and avoid mistakes, as well as potential security risks, related to manually creating users.
Read this article to learn how to setup the Calendly integration.
Prerequisites
- A JumpCloud Administrator account
- JumpCloud SSO Package or higher or SSO à la carte option
- A Calendly user account with administrator or owner permissions
- Calendly Enterprise plan and your Calendly ID
Important Considerations
- Calendly SCIM API is based on version 2.0 of the SCIM standard
- SSO is required to use SCIM
- To provision users, you must have available seats in Calendly. To view your available seats, go to your Admin Management page
- Removing Users:
- With a SCIM-enabled account, you can only remove users via JumpCloud. You cannot remove users via Calendly
- If you deactivate a user, their Calendly account is deactivated and the user loses access to Calendly; they cannot log in, host events, and people cannot schedule with them. The account can be reactivated at a later time
- If you delete a user, the user is removed from JumpCloud and their account is permanently deleted. Once you delete an account, you cannot retrieve it
- Groups are not supported
Attribute Considerations
- A default set of attributes are managed for users. See the Attribute Mappings section for more details.
Creating a new JumpCloud Application Integration
- Log in to the JumpCloud Admin Portal.
- Go to USER AUTHENTICATION > SSO Applications.
- Click + Add New Application.
- Type the name of the application in the Search field and select it.
- Click Next.
- Optionally, customize the display label, description and how the application displays:
- Description - add a description that users will see in their user portal
- User Portal Image - choose Logo or Color Indicator
- Show in User Portal - enable this option for this to be visible in the user portal
- Optionally, customize the IdP URL:
- Expand Advanced Settings and enter the name you want to use for the end of the SSO IdP URL, https://sso.jumpcloud.com/saml2/{custom_value}
The SSO IdP URL is not editable after the application is created. You will have to delete and recreate the connector if you need to edit this field at a later time.
- Click Save Application.
- If successful, click:
- Configure Application and go to the next section
- Close to configure your new application at a later time
Configuring the SSO Integration
To configure JumpCloud
- Create a new application or select it from the Configured Applications list.
- Select the SSO tab.
- Replace any instances of YOUR_ID with your Calendly ID.
- Add or change any attributes.
- Click save.
Download the certificate
- Find your application in the Configured Applications list and click anywhere in the row to reopen its configuration window.
- Click Actions > Download Certificate.
The certificate.pem will download to your local Downloads folder.
To configure Calendly
- In Calendly, go to your Admin center, select Login, then select Single sign-on.
- Under Step 1: Enter your identity provider information, enter the following information:
- Entity ID - enter JumpCloud.
- SSO URL - copy and paste the JumpCloud IDP URL.
- x.509 certificate - copy and paste the contents of the certificate downloaded in the previous section.
- Select Save & continue.
- Test the connection by selecting Enable SSO for yourself and then Test Connection.
- If successful, you will receive a confirmation.
Authorizing User SSO Access
Users are implicitly denied access to applications. After you connect an application to JumpCloud, you need to authorize user access to that application. You can authorize user access from the Applications, Users List or User Groups page.
To authorize user access from the Application’s page
- Log in to the JumpCloud Admin Portal.
- Go to USER AUTHENTICATION > SSO Applications, then select the application to which you want to authorize user access.
- Select the User Groups tab. If you need to create a new group of users, see Get Started: User Groups.
- Select the check box next to the desired group of users to which you want to give access.
- Click Save.
To learn how to authorize user access from the Users or User Groups pages, see Authorize Users to an SSO Application.
Validating SSO user authentication workflow(s)
IdP-initiated user workflow
- Access the JumpCloud User Console
- Go to Applications and click an application tile to launch it
- JumpCloud asserts the user's identity to the SP and is authenticated without the user having to log in to the application
SP-initiated user workflow
- Go to the SP application login - generally, there is either a special link or an adaptive username field that detects the user is authenticated through SSO
This varies by SP.
- Login redirects the user to JumpCloud where the user enters their JumpCloud credentials
- After the user is logged in successfully, they are redirected back to the SP and automatically logged in
Configuring the Identity Management Integration
To configure Calendly
- Sign in to calendly.com.
- Configure or ensure SSO is setup between Calendly and JumpCloud.
- Go to Account > Organization Settings > Single sign-on.
- Turn on SCIM Provisioning.
- Select Copy base URL.
- Select Generate bearer token, then select Copy token.
The Client ID and Secret (token) may only be shown once. Copy them to a secure location, like the JumpCloud Password Manager, for future reference.
- Select Test Connection.
- If successful, select Save.
To configure JumpCloud
- Create a new application or select it from the Configured Applications list.
- Select the Identity Management tab and then click Configure.
- You’re presented with two fields:
- Base URL: Paste the Base URL you copied when configuring Calendly. (e.g., https://api.calendly.com/scim/{tenantid}/v2)
- Token Key: Paste the Bearer Token you generated when configuring Calendly.
- Click activate and then click save.
- You will receive a confirmation that the Identity Management integration has been successfully verified.
- You can now connect user groups to the application in JumpCloud to provision the members of that group in Calendly. Learn how to Authorize Users to an Application.
After you've successfully integrated Calendly with JumpCloud, Calendly appears in the Applications list. You can now connect users to the application in JumpCloud to provision them in Calendly.
Tip: If you need to update the API Token at a later time, you will need to deactivate the integration before you can change the base URL and new API key. After you make the changes, you can re-activate the integration.
Attribute Mappings
The Export Attributes Mapping table lists the Required and Optional Mappings that JumpCloud sends to the Service Provider. See Attribute Considerations for more information regarding attribute mapping considerations.
Learn about JumpCloud Properties and how they work with system users in our API.
Modifying User Attributes
It's highly recommended you use all optional mappings. This creates a more complete user profile, enabling better automation and more accurate access management within the application.
To add user attributes
- From your connector’s configuration page, select the Identity Management tab.
- Expand the Export Attribute Mapping section and click Edit. The Optional Mappings table will open.
- Scroll to the bottom of the table and click +Add Attribute.
- Select one of the mapping types:
- Direct Mapping (JSON Path) - send the value from a user attribute in JumpCloud directly to an attribute in the service provider
- From the JumpCloud Attribute dropdown, select the desired attribute
- If you choose “Custom User Attribute” you must type the name of the attribute exactly as it on the user details page. To see the dropdown again, you must delete the attribute and add a new attribute
- From the SCIM Attribute dropdown, select the corresponding (destination) attribute
- From the JumpCloud Attribute dropdown, select the desired attribute
- Expression - transform or combine multiple user attributes into a single, custom value before sending it to the service provider
- Enter the expression in the JumpCloud Attribute field
- From the SCIM Attribute dropdown, select the corresponding (destination) attribute
- Constant - send a fixed, predefined value—like a specific company name —for every user to the service provider
- This is a free text field with no validation, e.g., the attribute must match exactly, including case, to the corresponding attribute in the user record. Once the custom attribute is added, you must delete it and readd a new custom attribute to see the dropdown again.
- Direct Mapping (JSON Path) - send the value from a user attribute in JumpCloud directly to an attribute in the service provider
- Repeat these steps for additional attributes.
- Click Preview Mappings to review the User Schema.
- If you do not select a specific user from the Preview Filter dropdown, the schema will default to the first user.
- Click Update.
Updates to the user schema will not dynamically sync. To force a sync, you must modify the user group’s record in some way, like adding a space to the Description field.
To modify existing user attributes
This new functionality is in Private Preview. Contact your Account Manager to enable it. Your feedback helps us evolve this feature so share your suggestions at the bottom of the article. Learn More
This enhancement gives you complete control over the user attributes sent from JumpCloud to this application. You can now:
- Fully control mappings - define which JumpCloud attribute or source data corresponds to an attribute in the SP's SCIM schema
- Use a variety of source values - map data from the user's standard attributes, Manager field, custom attributes, or other data sources
- Manipulate data with expressions - transform data, such as preferred first names and date format, using expressions before transmission to the SP. Learn more
- Preview changes - review your new mappings to ensure accuracy before you save
- From your connector’s configuration page, select the Identity Management tab.
- Expand the Export Attribute Mapping section and click Edit.
- For the type of attribute you would like to modify:
- Direct - select the new attribute from the dropdown(s)
- Expression - click in the Expression field and make the desired edits. If necessary, select the new attribute from the SCIM Attribute dropdown
- Custom - delete the existing values in either or both of the attribute fields and enter the new values
- Click Preview Mappings to review the updated User Schema.
- Click Update.
Updates to the user schema will not dynamically sync. To force a sync, you must modify the user group’s record in some way, like adding a space to the Description field.
To delete user attributes
- From your connector’s configuration page, select the Identity Management tab.
- In the Export Attribute Mapping section, click Edit. The Optional Mappings table will open.
- Click Delete (
) to remove any optional attributes.
- When finished, click Update.
Attributes that were initially included and populated in the user record and then deleted at a later time will not be modified or removed from the user record.
To restore the default Optional Mappings, click Edit > Restore Defaults > Update.
Calendly User Attributes
JumpCloud Property | JumpCloud UI Field Name | SCIM v2 Mapping | Calendly Value |
---|---|---|---|
username | Username | userName | Email address |
Company Email | emails:value | ||
active | Status | active | Active |
displayname | Display Name | displayName | Name |
employeeIdentifier | Employee ID | externalId | - |
Removing the Integration
These are steps for removing the integration in JumpCloud. Consult your SP's documentation for any additional steps needed to remove the integration in the SP. Failure to remove the integration successfully for both the SP and JumpCloud may result in users losing access to the application.
To deactivate the IdM Integration
- Log in to the JumpCloud Admin Portal.
- Go to USER AUTHENTICATION > SSO Applications.
- Search for the application that you’d like to deactivate and click to open its details panel.
- Under the company name and logo on the left hand panel, click the Deactivate IdM connection link.
- Click confirm.
- If successful, you will receive a confirmation message.
To deactivate the SSO Integration or Bookmark
- Log in to the JumpCloud Admin Portal.
- Go to USER AUTHENTICATION > SSO Applications.
- Search for the application that you’d like to deactivate and click to open its details panel.
- Select the SSO or Bookmark tab.
- Scroll to the bottom of the configuration.
- Click Deactivate SSO or Deactivate Bookmark.
- Click save.
- If successful, you will receive a confirmation message.
To delete the application
- Log in to the JumpCloud Admin Portal.
- Go to USER AUTHENTICATION > SSO Applications.
- Search for the application that you’d like to delete.
- Check the box next to the application to select it.
- Click Delete.
- Enter the number of the applications you are deleting
- Click Delete Application.
- If successful, you will see an application deletion confirmation notification.