Connect to Lark Address Book

1

Create Lark App

2

Configure Lark Address Book in GenAuth

3

Synchronize Organization from Lark to GenAuth

Create Feishu App

  1. If you haven't opened a Feishu developer account yet, please go to Feishu Open Platform (opens new window) to create a developer account first;

  2. In Developer Backstage (opens new window), click "Create Enterprise Self-built Application";

  3. Enter Application Name and Application Description, and upload the Logo;

  1. Click the "Confirm Creation" button.
Get application credentials

After creation, click on the application you just created to enter the application details page:

  1. On the Credentials and Basic Information page of the Feishu application details, you can get the App ID and App Secret of the application, and copy these two values;

  2. On the Connect Identity Source - Enterprise Identity Source page of the GenAuth console (opens new window), find Feishu Address Book;

  1. Copy App ID and App Secret Fill in the form:

  1. Click the "Save" button.
Configure event subscription (optional)

After configuring the event subscription, the operations in the Lark organization (such as the addition, deletion, modification, and query of departments, and the addition, deletion, modification, and query of users) will be synchronized to the GenAuth organization in real time. If you do not need this function, you can skip it.

  1. Configure event subscription on the Event Subscription page of Feishu application details;

  2. Determine whether to enable Encrypt Key. If you have high security requirements for message content, you can encrypt messages by agreeing on a key with Feishu Open Platform; Feishu Open Platform will use this key to symmetrically encrypt message content when pushing events. For details, please see Feishu Document - Overview of Subscription Events (opens new window). If you do not need to enable it, you can skip this step; if you do, please continue reading the following steps.

  3. If you haven't set the Encrypt Key yet, click the Reset button:

  1. Copy the latest Encrypt Key and Verification Token and fill in the configuration form of the GenAuth console:

  1. Set the request URL to:
https://core.genauth.ai/connections/enterprise/{ unique identifier }/{YOUR_USERPOOL_ID}/events

You need to replace { unique identifier } with the unique identifier filled in the identity source you are creating in GenAuth, and {YOUR_USERPOOL_ID} with your user pool ID.

You need to check the following events:

  • User status changes;

  • Department creation;

  • Department deletion;

  • Department information changes;

  • Address book scope permissions updated;

  • Employee joining;

  • Employee resignation;

  • Employee information changes;

  • User group creation;

  • User group deletion;

  • User group information changes;

Finally click Save.

Apply for permissions
  1. On the Permissions Management page of the Feishu app details, select the permissions required for the app, such as:

  • Get user email;

  • Get user phone number;

  • Get user userid;

  • Get user ID through phone number or email;

  • Get user basic information;

  • Get user unified ID;

  • Access address book as an app;

After setting permissions, you need to release the latest version.

Publish Application
  1. On the Version Management and Release page of the Feishu application details, click Create Version:

  1. Fill in the Application Version Number (format such as 1.0.0) and Update Description, set the availability status to Visible to All Employees, and finally click Save:

If the availability status is not Visible to All Employees, when importing the organization, it will prompt Failed to obtain Feishu organization department.

  1. After saving, click Apply for Release:

  1. After submitting the application, your enterprise administrator will review it, and the review results will be sent to you through Feishu and the developer backend. For details, please see Feishu Document - Developing Enterprise Self-built Applications (opens new window).
Back to list