Skip to content
Veraproof Veraproof Docs

n8n Integration

n8n Integration

Scimify enables SCIM provisioning for n8n, allowing you to manage users and global roles through your identity provider.

Overview

This integration (de)provisions users with n8n and supports global role management. Users will be created in a pending state and sent an email invite from n8n.

Prerequisites

  • An n8n Cloud instance or self-hosted n8n instance
  • Admin access to your n8n instance
  • Ability to generate API keys

Configuration Steps

1. Generate an n8n API Key

  1. Log into your n8n instance
  2. Navigate to your instance settings
  3. Go to the API keys section
  4. Generate a new API key
  5. Copy the API key

For more information, see the n8n API documentation.

2. Configure the Integration in Scimify

  1. Navigate to the Integrations page in your Scimify admin console
  2. Create a new n8n integration instance
  3. Enter the following configuration:
    • n8n Instance Name: Enter your instance name (e.g., “mycompany” for mycompany.app.n8n.cloud)
    • API Key: Paste the API key generated in Step 1

3. Configure Global Role Management (Optional)

To manage global roles via SCIM, you need to add the n8nGlobalRole custom attribute to your IdP profile:

SCIM Schema:

  • Schema: urn:ietf:params:scim:schemas:extension:custom:2.0:User
  • Attribute: n8nGlobalRole
  • Type: String
  • Description: The global role to assign to the user in n8n
  • Valid Values: admin, member
  • Default: If not specified, the default role will be assigned

4. Configure Okta SCIM

Follow the Okta SCIM Configuration guide to set up SCIM provisioning in Okta.

How It Works

User Provisioning

  • When users are pushed from your IdP, Scimify will create corresponding users in n8n
  • Users will be created in a pending state and will receive an email invite from n8n
  • Users must accept the invite to activate their account

Global Role Management

  • If you configure the n8nGlobalRole custom attribute in your IdP, Scimify will assign the specified role to users
  • Valid roles are:
    • admin: Full administrative access
    • member: Standard user access

Custom SCIM Attribute Configuration

To enable global role management, add the following custom attribute to your IdP user profile:

Schema: urn:ietf:params:scim:schemas:extension:custom:2.0:User
Attribute: n8nGlobalRole
Type: String
Values: admin, member

Additional Resources

Need Help?

If you encounter any issues during configuration, please contact support@veraproof.io for assistance.