Tariscope 4.5.x. Administrator's guide
Chapter 4 Tariscope configuration
4.12. Subscribers
4.12.1. Subscriber data input from Active Directory
Active Directory (AD) is a hierarchical arrangement of information about objects created by Microsoft for Windows domain networks. Active Directory makes use of Lightweight Directory Access Protocol (LDAP) versions 2 and 3, Microsoft's version of Kerberos, and DNS. The objects fall into two broad categories: resources and security principals (user or computer accounts and groups).
Tariscope allows you to import and synchronize the directory of subscribers from the enterprise Active Directory, eliminating the need for a separate maintaining the subscribers database. All changes to the structure of departments, extensions (internal phone numbers), contact information of the subscribers made in Active Directory will be reflected in an appropriate table of Tariscope database and immediately taken into account in the processing of new CDRs.
An example of Active Directory is shown in Figure 4.12.1.1.
Figure 4.12.1.1
For all subscribers in the Active Directory are given surname, first name, and a list of phone numbers belonging to a subscriber. The list of major fields of Active Directory used for synchronization with Tariscope is given in the table below.
| # | Name | Description |
| 1 | sn | Surname |
| 2 | givenName | First name |
| 3 | postalCode | Postal Code |
| 4 | City | City |
| 5 | streetAddress | Street |
| 6 | physicalDeliveryOfficeName | Office name |
| 7 | ||
| 8 | whenCreated | When created |
| 9 | Phone | Phone number |
| 10 | Mobile | Mobile number |
| 11 | telephoneNumber | Second phone number |
To synchronize data from Active Directory into Tariscope, you should create a profile. To do this, in the Tariscope menu, select Additional options → Integration → Active Directory. The Active Directory page appears as shown in Figure 4.12.1.2.
Figure 4.12.1.2
The Active Directory page contains the toolbar with the following icons:
- New profile. Allows you to create a new profile for data synchronization.
- Start import. Data synchronization starts.
- Delete. Allows you to delete the selected profile.
- Export of the table. Allows you to export the Active Directory table into the external file. Supports the following formats: Excel, HTML, CSV, PDF.
To create a new profile, click on the New profile icon on the toolbar. The New synchronization profile for Active Directory page appears as shown in Figure 4.12.1.3.
Figure 4.12.1.3
Click on the Connect to LDAP/AD button. The Connect to LDAP/AD page appears as shown in Figure 4.12.1.4.
Figure 4.12.1.4
In the Server (domain) box, enter IP address of the AD server or its domain name.
In the Root DN box, enter the root element of the Active Directory service.
In the User name box, enter a username.
In the Password box, enter the password.
In the Authentication method list, select an item that corresponds to the method used in AD.
If you want to keep the password, turn on the Save password switch.
Click Connect. If you have correctly entered the connection parameters, the configuration page will be like as shown in Figure 4.12.1.5.
Figure 4.12.1.5
Using the switches from the Select root elements list, select the elements which should be imported. The page will be like it is shown in Figure 4.12.1.6.
Figure 4.12.1.6
Click Next to move the second step of the configuration (Figure 4.12.1.7).
Figure 4.12.1.7
On this configuration step, you should select a telecommunications node, company, and subscriber group where data from AD will be imported. This choice is performed in the Select group list.
To assign a rate plan for subscribers, select it in the Plans list.
If a numbering plan was created in the Tariscope system and it should be considered when importing subscribers, turn on the Use numbering plans switch.
If you want to import data only from the Users folder of the Active Directory and import the department names, turn on the Skip default AD containers switch.
If you do not need to import subscribers from AD that do not have extensions, turn on the Skip subscribers without extensions switch.
If you use a numbering plan in Tariscope and do not want to import subscribers whose extensions are not included in this numbering plan, turn on the Skip extensions without numbering plan switch.
If Tariscope contains subscribers that have been moved to another group in AD, and you want such subscribers to be moved to these groups in Tariscope too, turn on the Change group switch.
If the synchronization profile will be used only to receive data for new subscribers and you do not need to update the data on subscribers that are already in the Tariscope database, turn on the Update only switch.
Click Next. The page displays the third step of the profile configuration (Figure 4.12.1.8).
Figure 4.12.1.8
You need to link the AD fields with the Tariscope fields. Tariscope tries to independently link the existing fields. Check that the data binding is correct and, if necessary, make changes by selecting the desired value from the list. Click Next.
The page of the 4th step of setting is shown in Figure 4.12.1.9.
Figure 4.12.1.9
In the Profile name box, enter the required name.
The Summary information section of this page displays some of the previously set sync options.
Click Save. The name of the created synchronization profile will be displayed in the table of the Active directory page (Figure 4.12.1.10).
Figure 4.12.1.10
To import data about subscribers from AD, click on the Start import icon on the toolbar (Figure 4.12.1.11). Tariscope will perform such an import.
Figure 4.12.1.11
If you need to periodically synchronize data between AD and Tariscope, you should use the Tariscope Tasks by creating a corresponding task in it, in which you specify the required data synchronization profile created on this settings page.
