Setting Up SCIM Integration with Vizzlo

Introduction

This article explains how to set up SCIM (System for Cross-domain Identity Management) integration with Vizzlo, allowing Enterprise IT administrators to automate user provisioning and management.

Prerequisites

• Vizzlo Enterprise or Education plan subscription
• Administrative access to your Vizzlo organization
• Administrative access to your Identity Provider (IdP) such as Okta, OneLogin, or Microsoft Entra ID

What is SCIM?

SCIM is a standardized protocol that automates the exchange of user identity information between Service Providers (like Vizzlo) and Identity Providers. With SCIM integration, you can automate the provisioning and deprovisioning of users in your Vizzlo organization.

Configuration Details

Key Information

• SCIM Base URL: https://vizzlo.com/scim/v2/orgs/{organizationId}
• Authentication: Bearer Token
• Protocol Version: SCIM 2.0

Step 1: Find Your Organization ID

1. Log in to Vizzlo and access your dashboard
2. Click the Vizzlo menu in the top left and select your organization to go to the organization's admin interface
3. Look at the URL in your browser - it will be in the format https://vizzlo.com/o/XXXXXXXXXXX
4. The string of characters after /o/ is your organization ID (XXXXXXXXXXX in this example)

Step 1: Generate a Bearer Token

1. Have any administrator of your Vizzlo organization log in to Vizzlo
2. Navigate to https://vizzlo.com/settings
3. Generate an API token to use as the Bearer Token for SCIM authentication

Step 2: Configure Your Identity Provider

In your IdP's admin console, add Vizzlo as a SCIM-enabled application:

1. Enter the SCIM Base URL with your organization ID
2. Configure authentication using the Bearer Token generated in Step 2
3. Map the required user attributes from your IdP to Vizzlo's SCIM fields

Currently Supported Features

Vizzlo currently supports a basic feature set based on the requirements of our Enterprise customers:

• API Level: SCIM 2.0
• User Provisioning: Creating new managed users in Vizzlo
• User Deprovisioning: Deletion of managed users from Vizzlo

Current Limitations

The following features are currently not supported:

• Updating existing users
• Management of teams
• Automated subscription updates
• SCIM 1.1 protocol
• Bulk operations
• Custom SCIM attributes
• SCIM filters
• Password management via SCIM
• Caching/ETag support

Note: SCIM configuration is currently not available in the admin UI and must be set up using the provided API endpoints.

Troubleshooting

• Verify your organization is on the Enterprise or Education plan
• Ensure the Bearer Token is valid and was generated by an organization admin
• Check that your organization ID is correct in the SCIM Base URL
• Confirm attribute mappings are correctly configured in your IdP

Related Features

For complete identity management, consider also configuring SAML integration:

• Entity ID: https://vizzlo.com
• ACS URL: https://vizzlo.com/sso/saml2

For more details on setting up SAML, see our SAML setup documentation.

Support

If you encounter any issues during setup or have questions about the SCIM integration, reach out to our support team for assistance.