Creating an Integration Id for Schlage Mobile Credentials.

The Integration Id is a secure way to identify your mobile application (built with the Mobile Credential SDK) and is required to link the user's phone with your ENGAGE account and your access control system.

1. Signing ID Tokens:

   ID Tokens are used to uniquely identify a user within your access control system

   Generate a key pair for signing ID Tokens and share the public key with Allegion via email. This needs to be an ECC key pair using the secp256r1 (NIST P-256) curve. You can generate this key pair with the tool of your choice, however we have included steps below to generate the key pair with OpenSSL.

   openssl ecparam -name secp256r1 -genkey -out COMPANY_id.pem
   

   Write your public key to a file "COMPANY_id_pub.pem". (an Allegion developer would save this file as "allegion_id_pub.pem")

   openssl ec -in COMPANY_id.pem -pubout -out COMPANY_id_pub.pem
   

   Email Allegion the file "COMPANY_id_pub.pem".

   Get your private key for signing ID Tokens.

   openssl ec -in COMPANY_id.pem -text
   

2. Signing Access Tokens:

   Access Tokens are used to uniquely identify credentials within your access control system

   Generate a key pair for signing Access Tokens and share the public key with Allegion via email. This needs to be an ECC key pair using the secp256r1 (NIST P-256) curve. You can generate this key pair with the tool of your choice, however we have included steps below to generate the key pair with OpenSSL.

   openssl ecparam -name secp256r1 -genkey -out COMPANY_access.pem
   

   Write your public key to a file "COMPANY_id_pub.pem". (an Allegion developer would save this file as "allegion_id_pub.pem").

   openssl ec -in COMPANY_access.pem -pubout -out COMPANY_access_pub.pem
   

   Email Allegion the file "COMPANY_access_pub.pem".

   Get your private key for signing Access Tokens.

   openssl ec -in COMPANY_access.pem -text
   

3. ENGAGE login

   Provide Allegion with your login email for Production ENGAGE. This is the email address you use to sign in at https://portal.allegionengage.com or to sign in to the ENGAGE Production app. Email Allegion this value.

4. Allegion will respond with your unique Integration Id

5. Verify you have access to the Credentialing API on the Allegion Developer Portal.

   • Sign up for an account on the Production Developer Portal https://developerapi.allegion.com and notify Allegion via email that you have signed up.
   • Subscribe to "Schlage Mobile Credential" to get your Production subscription key.
   • Make sure to read through the documentation, download the SDK, and try out the sample code.