• Overview
  • Configuration

Notion

Enhance collaboration with Notion and ADManager Plus Iintegration

Identity provisioning

Notion is a productivity and note-taking application that empowers organizations with real-time collaboration and project management. Integrating ADManager Plus with Notion optimizes user lifecycle management by syncing Notion with Active Directory, and streamlining user provisioning. By automating onboarding and offboarding,this integration ensures that team members have immediate access to productivity tools, with minimal manual intervention. With real-time updates and accurate data synchronization, organizations can ensure efficient role management and smooth transitions, elevating productivity and collaboration.

 

Hassle free user onboarding

Enable an efficient onboarding experience by integrating ADManager Plus with Notion, granting employees immediate access to relevant collaborative resources and fostering their productivity from day one.

 

Frictionless user offboarding

Upon exiting the organization, ADManager Plus automatically revokes employee access to relevant workspaces in Notion, ensuring a smooth offboarding process and eliminating security vulnerabilities from inactive users.

 

Configuration Document: Integrating Notion with ADManager Plus

Prerequisites:

Please ensure to provide the bearer token to retrieve desired information and perform tasks in Notion. Refer to Notion' API references for more details.

Privileges:

  • To import users from Notion (inbound action): Ensure the account used for authorization has permission to read all user accounts.
  • To perform any action or query in Notion (outbound action): Ensure the account used for authorization has permission to perform the desired action.
Note: ADManager Plus comes with pre-configured set of APIs that helps perform basic actions with the integration. If the action you require is not available, please gather the necessary API details from Notion API documentation to configure under inbound/outbound webhooks to perform the required actions.

Authorization configuration

  • Log in to ADManager Plus and navigate to the Automation tab.
  • In the left pane, under Configuration, click Application Integrations.
  • Under Enterprise Applications, click Notion.
  • Toggle the Enable Notion Integration button on.
  • In the Notion Configuration page, click Authorization.
  • Perform the steps to generate Bearer token in Notion and paste the Bearer token the Value field.
  • Click Configure.

Inbound webhook configuration

Inbound webhook enables you to fetch user data from Notion to ADManager Plus. The attribute mapping configured in this section can be selected as the data source during automation configuration. perform the desired action on the list of users received from the API response.

To configure an inbound webhook for Notion:

  • Under Inbound Webhook, click Notion Endpoint Configuration.
  • In the Endpoint Configuration tab, an endpoint, Notion USERS ENDPOINT, comes pre-configured with an Endpoint URL, API Method, Headers, and Parameters fields to fetch user accounts from Notion. If you would like to use this pre-configured endpoint, replace {company_id} with the domain name of your Notion instance in the Endpoint URL field. However, if you would like to use a new endpoint to import users, you can configure one using the + Add API endpoint button and filling in the required fields as per Notion's API references. Click here to learn how.
  • Note:

    • The API key value pair is pre-configured as a header for authenticating API requests as configured during Authorization Configuration.
    • Macros: You can add macros to your endpoint configuration to dynamically change it as per your requirement using the macro chooser component.
    • Refer to Notion's API references and configure additional headers and parameters, if required.
  • Once done, click Test & Save. A response window will display all the requested parameters that can be fetched using the API call. Click Proceed.
  • Note:

    • Refer to Notion's API references to know the Parameters that must be configured to fetch only specific parameters.
    • You can configure multiple endpoints for Datadog using the + Add API endpoint button. Click here to learn how.
  • Click Data Source - LDAP Attribute Mapping to match endpoints and to map AD LDAP attributes with the respective attributes in Notion.
  • Click + Add New Configuration and perform the following:
    • Enter the Configuration Name and Description and select the Automation Category from the drop-down menu.
    • In the Select Endpoint field, select the desired endpoint and a Primary Key that is unique to a user (e.g. employeeIdentifier).
    • Note: When multiple endpoints are configured, this attribute must hold the same value in all the endpoints.
    • In the Attribute Mapping field, select the attribute from the LDAP Attribute Name drop-down menu and map it with the respective column in Notion.
    • If you would like to create a new custom format for this, click Add New Format.
    • Click Save.