Create a public/private key pair for the Microsoft OneDrive external content connector

Generate a public/private key pair for the Microsoft OneDrive external content connector. Extract the public key as a DER-encoded binary X.509 format certificate for use in configuring API access for the connector in the Microsoft Entra admin center.

Before you begin

You must have access to the Java keytool utility. For details on the keytool utility, see https://docs.oracle.com/en/java/javase/21/docs/specs/man/keytool.html.

Role required: none

About this task

The Microsoft OneDrive external content connector uses a public/private key pair to authenticate with an OAuth 2.0 app configured in the Microsoft Entra admin center. Key pair authentication allows the connector to access your Microsoft OneDrive data via the Microsoft Graph API.

To configure public/private key pair authentication for the connector, you need to create the following items:

1. A public/private key pair in Java KeyStore (JKS) format.
   • Your connector administrator needs this JKS keystore file and its password when configuring settings for the Microsoft OneDrive external content connector.
   • When the Microsoft OneDrive external content connector runs a crawl, it uses the private key from this JKS keystore file to sign the authentication request it sends to the OAuth 2.0 app defined in the Microsoft Entra admin center.
2. A copy of the public key in DER-encoded binary X.509 certificate format.
   • Your administrator needs to upload this certificate file to the OAuth 2.0 app defined in the Microsoft Entra admin center that grants API access to the Microsoft OneDrive external content connector.
   • When the Microsoft OneDrive external content connector submits its authentication request to the OAuth 2.0 app defined in the Microsoft Entra admin center, the app uses the public key from this uploaded certificate to confirm that the authentication request was signed with the private key.

Note:

If your organization has its own guidelines for generating public/private key pairs, follow those to generate a key pair and a public key certificate in the required formats.

Procedure

1. Generate a public/private key pair in JKS keystore format:
   1. Run this keytool command, replacing <alias>, <jks-file>, and <password> with values of your choice:

      keytool -genkey -alias <alias> -keyalg RSA -keysize 2048 -keystore <jks-file>.jks -storepass "<password>" -storetype JKS -validity 360

      As an example, you might specify ms-onedrive-connector-cert as the key alias and the JKS repository filename, and enter a password:

      keytool -genkey -alias ms-onedrive-connector-cert -keyalg RSA -keysize 2048 -keystore ms-onedrive-connector-cert.jks -storepass "lwmoWTbbT+j+qvdQ" -storetype JKS -validity 360

   2. When prompted for your first and last name, enter the Common Name (CN) you want for the key pair, then press Enter.
      As an example, you might specify Microsoft OneDrive external content connector as the Common Name for the key pair.
   3. At each of the remaining distinguished name prompts, enter the requested information and press Enter.
   4. When prompted to confirm that the distinguished name is correct, enter yes and press Enter.
   5. When prompted for a key password, press Enter to use the same password you specified for the keystore file.
      Important:

      The key must use the same password as the keystore. Record this password in a secure location. Your connector administrator needs this password when configuring the Microsoft Teams external content connector.
   The keytool utility generates a new Java KeyStore (.jks) file containing your public/private key pair.

   Important:

   Ignore the keytool warning message about migrating your keystore to the PKCS12 format. The external content connector only supports the Java KeyStore format.
2. Export your public key in DER-encoded binary X.509 certificate format by running the following keytool command, replacing <cer-file> with a filename of your choice and replacing <alias>, <jks-file>, and <password> with the same values you used in step 1:

   keytool -export -alias <alias> -file <cer-file>.cer -keystore <jks-file>.jks -storepass "<password>" -storetype JKS

   As an example, you might specify ms-onedrive-connector-cert as the filename for the DER-encoded binary X.509 format certificate:

   keytool -export -alias ms-onedrive-connector-cert -file ms-onedrive-connector-cert.cer -keystore ms-onedrive-connector-cert.jks -storepass "lwmoWTbbT+j+qvdQ" -storetype JKS

   The keytool utility exports a copy of your public key as a DER-encoded binary X.509 format certificate file with your chosen filename.

   Important:

   Ignore the keytool warning message about migrating your keystore to the PKCS12 format. The external content connector only supports the Java KeyStore format.

What to do next

Provide both of the files you generated to the admins who configure your Microsoft OneDrive instance and AI Search on your ServiceNow AI Platform® instance, as follows:

File	Description
DER-encoded binary X.509 format public key certificate file	Provide this certificate file to your Microsoft OneDrive administrator. They will need to upload the certificate to the Microsoft Entra admin center when configuring an OAuth 2.0 application for the Microsoft OneDrive external content connector. For more information on configuring an OAuth 2.0 application in the Microsoft Entra admin center for the Microsoft OneDrive external content connector, see Configure Microsoft OneDrive for external content indexing.
JKS keystore file and password	Provide this Java KeyStore file and its password to your ServiceNow AI Platform admins. They will need the file and password when configuring the Microsoft OneDrive external content connector. For details on creating and configuring the Microsoft OneDrive external content connector, see Create a Microsoft OneDrive external content connector.