# Import From Dingtalk

Authing supports importing organizations and users from Dingding address book, and synchronizing the changes of Dingding organization to Authing's organization.

# Configure Dingding Address Book

# Create Dingding Application

  1. You need to first DingTalk Open Platform (opens new window) to register an internal application with address book permissions, as shown in the figure below:

Choose the development model for enterprise self-development:

On the permission management page, add all permissions related to the address book:

# Configure server export IP

Fill in the export IP address of your server here:

Due to the limitation of the Dingding platform, the same IP can only be used by one company, so you need to deploy a proxy with https forwarding capability on the server corresponding to the **server export IP. Authing will be performed through this proxy and Dingding server Communication. You can use open source proxy solutions such as goproxy (opens new window), or buy an anonymous proxy IP. If you don’t know how to deploy, please see:

Deploy a transit proxy server

# Configure in the Authing console

Find the DingTalk Address Book on the Connect Identity Source-Corporate Identity Source page:

Here you need to fill in the following information:

-Corporate ID (CorpId) -AppKey of Dingding app -Dingding AppSecret -Server export agent

Please make sure that the application ID and key are correct, and the proxy is available, otherwise you may encounter the following prompt:

# First full sync

After successful configuration, you can import the organizational structure and users in the DingTalk corporate address book to the Authing organization. Below we will take Beijing Feihua Technology Co., Ltd. (virtual, hereinafter referred to as Feihua company) as an example:

This is the initial organizational structure of the extraordinary company. There are three departments and 4 employees:

On the User Management-Organizational Structure page of the Authing console, click Import Organization-Import from Dingding:

After a short period of time, the DingTalk organization will be imported into the Authing organization:

You can check the progress on the synchronization history page:

# From DingTalk incremental synchronization to Authing organization

# Synchronize changes in organizational structure

# Add department

Added a legal department here:

You can see that it was immediately synchronized to the Authing organization:

Add a Greater China department under the commercialization department:

After a while, he was also synchronized to the Authing organization:

# Delete department

Delete the legal department:

It has also been deleted from the Authing organization:

# Modify department

Here the R&D department is renamed Production Research:

You can see that it was successfully updated:

# Synchronize personnel changes

# Add members

Add a new member under the operations department:

# Delete member

Delete the member just added:

# Modify member information

Modify Xiaohong’s name to Xiaohonghong:

# View synchronization history

You can click Import Organization-View Import History to view the progress on the Sync History page:

If the synchronization fails, you can see the detailed error log here: