Set up the Kubernetes spoke
Integrate the ServiceNow instance and Kubernetes using an API key and certificate to authenticate ServiceNow requests.
Before you begin
- Request an Integration Hub subscription.
- Activate the Kubernetes spoke.
- Role required: admin.
Generate Kubernetes API token and certificate
Generate an access token and a certificate from your Kubernetes account for API key authentication.
Before you begin
Kubernetes requirements:
- Kubernetes account.
- Role required: administrator with credentials on the host machine where Kubernetes is installed.
About this task
Complete these steps from your Kubernetes host machine. See Kubernetes documentation for instructions on generating your API token and client certificate.
Procedure
From your Kubernetes host machine, generate an access token to interact with Kubernetes APIs.
This token does not expire.
Copy and record the access token to create Credential records on your ServiceNow instance.
Generate a client certificate to upload to your ServiceNow instance.
Upload Kubernetes client certificate
Upload the Kubernetes client certificate to your ServiceNow instance to authenticate API requests to the Kubernetes host machine.
Before you begin
Role required: admin.
Procedure
Navigate to All > System LDAP > Certificates.
Click New.
Complete the form and enter the certificate in the PEM Certificate field.
For more information about uploading certificates, see Upload a certificate to an instance.
Click Submit.
Configure a connection for the Kubernetes spoke
Add and configure the Kubernetes connection to authenticate ServiceNow requests in Kubernetes spoke.
Before you begin
Role required: admin
Procedure
Navigate to All > Process Automation > Workflow Studio.
Click the Integrations tab.
Under Connections, toggle and enable the Outbound connections.
Locate the alias for Kubernetes and click View Details.
- To configure the default connection and credential alias record that is shipped along with the Kubernetes spoke, click View Details.
Connection for the Kubernetes spoke.
- To manage more than one Kubernetes spoke connection records, you should create a new child alias record by clicking **Add Connection**. For more information about using multiple connections, see [Supporting multiple connections](support-multiple-connections.md).
If you are configuring the spoke for the first time, click **Configure**. Otherwise, click **Edit**.
First-time connection configuration.
On the Connection form, fill in the fields.
Field Description Connection Name Name to identify the Kubernetes connection alias record. Connection URL IP address and port of the host machine where Kubernetes is installed. API Key Token you obtained from Kubernetes in this format: Bearer {access token}.
Configure a connection for the Kubernetes spoke.
- Click Configure Connection.
Result
The spoke connection is configured and ready to be used.
Turn off remote SSL host verification
A system property prevents the Kubernetes spoke from processing Kubernetes responses. Set the com.glide.communications.httpclient.verify_hostname system property to false to enable the integration.
Before you begin
Role required: admin.
Procedure
Enter
sys_properties.listin the application navigator.The System Properties [sys_properties] table opens.
Search for the com.glide.communications.httpclient.verify_hostname system property.
Set the value to false.