Skip to main content
This section covers configuration tasks you must make on the KMES Series 3 for Google EKM to access externally managed keys. For all the tasks in this section, you must log in to the KMES application interface with the default Admin identities.

​
Configure TLS certificates

Perform the following steps to configure TLS certificates for the Rest API connection pair:
1
Go to Administration> Configuration> Network Options.
2
In the Network Options dialog, go to the TLS/SSL Settings tab.
3
Select the REST API connection pair in the drop-down menu.
4
Ensure that the REST API connection pair is Enabled and configure the TLS settings as needed.

​
Add JWT identity provider

You must configure a JSON Web Token (JWT) to allow Google to authenticate against the KMES by using the Google-generated JWT.
1
Go to Identity Management> Identity Providers, right-click the background, and select Add> Provider> JSON Web Token.
2
Go to the Info tab of the Identity Provider Editor window, specify a name for the identity provider, and de-select Enforce Dual Factor.
3
Go to the JWT Options tab and specify https://accounts.google.com as the issuer. Set leeway and max validity according to your requirements.
4
Go to the JWT Key tab, select JWKS, and specify https://www.googleapis.com/oauth2/v3/certs in the JWKS URL field. Leave the TLS PKI field blank and select [ OK ]* to save.
5
Right-click the identity provider that you created and select Add> Mechanism> Google External Key Manager.
6
Go to the Info tab and specify a name for the authentication mechanism.
7
Go to the Audience tab and specify the hostname of your KMES and the REST API port number (8081 by default) in the following format: https://<host name>:<port>.
8
Select [ OK ] to save.
The newly added identity provider and authentication mechanism display.

​
Create an identity for the Google Service Account

Perform the following tasks to create an identity for the Google Service Account and grant it the required permissions:

​
Create a new role

1
Navigate to the Identity Management > Roles menu and add a new role.
2
In the Role Editor window, name the role Google Key Management and change the number of logins required to 1. Leave all other fields set as the default values on the Info tab.
3
On the Permissions tab, select the following Cryptographic Operations permissions:
  • Sign
  • Wrap
  • Unwrap
4
Select [ OK ] to save.

​
Create an identity

Perform the following steps to create a new identity and assign it to the Google key management role:
1
Go to the Identity Management > Identities menu. Right-click the background and select Add > Client Application to add a new identity.
2
On the Info tab of the Identity Editor window, specify a name for the identity.
3
On the Assigned Roles tab, select the Google Key Management role.
4
On the Device Info tab, enter the Google service account email address (for example, service-54255661635@gcp-sa-ekms.iam.gserviceaccount.com) that you noted in the key creation wizard into the Email field.
5
On the Authentication tab, select [ Add ] to add a new credential. In the Configure Credential window, select Google External Key Manager as the credential type, and then select the provider and mechanism configured in the previous selection. Select [ OK ].
6
Remove the default API Key mechanism, leaving only the Google External Key Manager credential, and select **[ OK ]***to save.