Configuring Your Custom PACS Adapter for MicroStrategy Identity

You can let users unlock physical resources, such as locked doors or offices, using the MicroStrategy Badge app on their smartphone. To provide access to locations that are secured with your physical access control system (PACS), you integrate your PACS with MicroStrategy Identity.

You integrate your PACS with MicroStrategy Badge through a web service adapter that communicates to the PACS server.

If your PACS is not a standard option available in MicroStrategy Identity Manager, you can integrate your PACS by creating an adapter that uses the custom PACS API.

When your PACS successfully connects to Identity, each physical access point secured by the PACS is loaded into the Identity Server as a digital key. To control which users have permission to unlock each physical access point, you must manage user permissions in the PACS. You can customize how keys are displayed to users in the MicroStrategy Badge app. For examples and steps to customize keys, see Managing Physical Access Keys.

You can also secure the adapter by completing an optional step that ensures that only MicroStrategy Identity Server communicates with the adapter. This process is included in the steps below.

After the custom PACS adapter is integrated, you can verify that it is running and refresh the cache of users and permission information. For steps, see the following:

• Diagnosing the Custom PACS Adapter Health
• Refreshing the Custom PACS Adapter Cache

To Enable Physical Access with MicroStrategy Identity to Locations Secured by Your Physical Access Control System

1. Log into MicroStrategy Identity Manager:
   1. Navigate to the Identity Manager home page.
   2. On your smartphone, open the MicroStrategy Badge app and scan the displayed QR code.
2. Click Physical Gateways.
   
3. Under Building Access, click the Custom PACS icon .
4. Click Next.
5. Provide the following information:
   • Configuration Name (required): A descriptive name for this connection to your PACS. This is the name that you see in MicroStrategy Identity Manager.
   • Adapter Server URL (required): URL of the PACS adapter server, as described in the Configuring Your Custom PACS Adapter for MicroStrategy Identity, such as http://IPaddress:port, http://hostname:port, or https://hostname:port.
   • Adapter Service Path (required): Path of the PACS adapter, as described in the Configuring Your Custom PACS Adapter for MicroStrategy Identity.
   • User ID Mapping (required): The field to use to look up PACS users, as described in the Configuring Your Custom PACS Adapter for MicroStrategy Identity.
     If the users in your network are added manually or by importing a comma-separated values (CSV) file, type the Identity profile field that contains information used to look up PACS users, as described in the Configuring Your Custom PACS Adapter for MicroStrategy Identity. Select from the following fields:
     • If PACS users are identified by their first name, type first_name.
     • If PACS users are identified by their last name, type last_name.
     • If PACS users are identified by their email address, type email.
     • If PACS users are identified by their title, type title.
     • If PACS users are identified by an alternate value that you provided when you added users to your Identity Network, type user_name.
   • SSL Bypass: By default, communication is encrypted with secure sockets layer (SSL). To use plain, unencrypted communication between the adapter and Identity, type true.
6. Click Refresh. When MicroStrategy Identity successfully connects to the adapter, a green check mark is displayed.
7. Click Next. The keys in your PACS are loaded into MicroStrategy Identity.

8. To secure the adapter by verifying that the adapter communicates with MicroStrategy Identity Server, you can create a certificate for MicroStrategy Identity Server. To do this, click Support to contact MicroStrategy and request help creating a certificate.

Next, you can customize how keys are displayed in the MicroStrategy Badge app. See Managing Physical Access Keys.

Related Topics

Categorizing MicroStrategy Badge Resources

Physical Gateways