Managing clients and integrations
The client is a data communication entity that is used to get access to data-residency services of InCountry Platform within the allocated environment.
All clients are attributed to the specific environment within which you created them.
To view the clients for a specific environment, on the menu, select Environments and then select the environment.
On the environment details page, you can view the three blocks, as follows:
Clients - shows the number of clients created.
Integrations - shows the number of integrations created.
Encryption Keys - shows the number of encryption keys created.
Within each environment, you can have multiple clients that you can use to manage data records on the InCountry platform with the SDK. Additionally, you can create integrations for the operation of the InCountry Data Residency for Salesforce package, data communication through REST API, management of serverless functions, or operation of Border. Besides this, you can also manage encryption keys for a specific country where you store regulated data records.
Managing clients
A client is a set of credentials (Client ID and Client Secret) that you can use to connect to a secure data store provided by the InCountry platform in a specific country.
You can manage clients, as follows:
create new clients
edit names of existing clients
delete the no longer needed clients
Creating new clients
By default, InCountry Portal does not create a default client together with the creation of a default environment. You can create a new client once needed.
To create a new client:
Open a specific environment within which you want to create a new client.
Click Generate client.
On the New Client form, enter the name of the client.
Click Next.
Enter the verification code and click Create.
InCountry Portal generates the credentials (Client ID and Client secret) that you can you further use to manage data on the InCountry platform.
On the newly opened page, copy the Environment ID, Client ID, and Client Secret. Save them in a secure place as you will not be able to recover them. To download a text file with all these credentials, click Download text. To copy these credentials to the clipboard, click Copy to clipboard.
When complete, click Close.
A new client will appear within the environment.
note
You can create up to 10 clients in one production environment.
Updating the client name
You may need to rename the client in some cases if the current name does not reflect the actual purpose of the client.
Open the environment.
Click the Environments block.
On the list with clients, locate the client you want to rename.
Click the Change Client Name icon.
On the Client Parameters page, update the name for the client.
Click Next.
Enter the verification code and click Update.
Deleting the client
If you no longer need some client, you can delete it. After the removal, the client credentials will be no longer valid, so you cannot use them for further data management on the InCountry Platform. To get access to data stored within the environment, you will need to create a new client.
Open the environment.
Click the Environments block.
On the list with clients, locate the client you want to delete.
Click the Delete Client icon.
Enter the verification code and click Delete.
note
If you delete the automatically generated client for a specific integration, this integration will no longer work.
Managing integrations
Integration is an entity representing a connection point that can be used to integrate your system with other components of the InCountry Platform.
You can manage integrations, as follows:
create new integrations
renew existing integrations
delete the no longer needed integrations
note
Please consider that you can create only integration of each type per one country. You cannot create multiple Salesforce, serverless, or REST API integrations for the same country within the same environment.
Creating new integrations
InCountry Portal does not create a default integration together with the creation of a default environment. You can create an integration of the four types, as follows:
Salesforce is used for the operation of the InCountry Data Residency for Salesforce package.
Serverless is used for the management of serverless functions on the target Point-of-Presence (PoP).
restapi-sse is used for data communication with REST API.
Border is used for data communication through Border.
Creating a new Salesforce integration
Open the environment in which you want to create a new integration.
Click Create integration.
On the New Integration page, define the configuration of the integration, as follows:
Type - select the
Salesforce
integration type from the list.Name- enter the name of the integration.
Country - select the country for integration setup.
Click Next.
Enter the verification code.
Click Create.
On the page with the created Salesforce integration, save the environment ID, Client ID, Client Secret, and REST API address. To download a text file with all these credentials, click Download text. To copy these credentials to the clipboard, click Copy to clipboard.
When complete, click Close.
Uploading the public certificate
Once you have created the Salesforce integration and registered a self-signed certificate in Salesforce, you need upload the public certificate in the CRT format to the InCountry Portal.
Open the environment where the Salesforce integration was created.
Click the Integrations block.
On the list with integrations, locate the integration of the Salesforce type.
Click the Upload Certificate icon.
Click Select Certificate and select the public certificate you downloaded from Salesforce.
Click Next.
Enter the verification code and click Upload.
note
Salesforce generates a certificate for one year, after this period you need to re-generate the certificate and upload its new version on the DRaaS. Click the Replace Certificate icon and upload a new version of the certificate. The procedure is quite similar to certificate upload.
Creating a new Serverless integration
Open the environment in which you want to create a new integration.
Click Create integration.
In the Create Integration form, specify the following information:
Type - select the
Serverless
integration type from the list.Name - enter the name of the integration.
Country - select the country for integration setup.
Click Next.
Enter the verification code.
Click Create.
On the page with the created serverless integration, save the environment ID, Client ID, Client Secret, and REST API address. To download a text file with all these credentials, click Download text. To copy these credentials to the clipboard, click Copy to clipboard.
When complete, click Close.
A new serverless integration will appear on the list with other integrations within the current environment. Having created a serverless integration, you can proceed with the publication of serverless scripts.
Creating a new REST API integration
Open the environment in which you want to create a new integration.
Click Create integration.
In the Create Integration form, specify the following information:
Type - select the
REST API (SSE)
integration type from the list.Name - enter the name of the integration.
Country - select the country for integration setup.
Click Next.
Enter the verification code.
Click Create.
On the page with the created REST API integration, save the environment ID, Client ID, Client Secret, and REST API address. To download a text file with all these credentials, click Download text. To copy these credentials to the clipboard, click Copy to clipboard.
When complete, click Close.
A new REST API integration will appear on the list with other integrations within the current environment.
Creating a new Border integration
Open the environment in which you want to create a new integration.
Click Create integration.
In the Create Integration form, specify the following information:
Type - select the
Border
integration type from the list.Name - enter the name of the integration.
Country - select the country for integration setup.
Click Next.
Enter the verification code.
Click Create.
On the page with the created REST API integration, save the environment ID and Border address. To download a text file with all these credentials, click Download text. To copy these credentials to the clipboard, click Copy to clipboard.
When complete, click Close.
A new REST API integration will appear on the list with other integrations within the current environment. You can proceed with defining the Border configuration.
Renewing the integration
You can renew Client ID and Client Secret that are used within a particular integration. This may be required for key rotation or when you lost the client secret but do not want to create a new integration.
Open the environment.
Click the Integrations block.
On the list with integrations, locate the integration you want to renew.
Click the Renew Integration icon.
Confirm the operation by clicking Renew.
Enter the verification code.
On the page with the renewed integration, save the environment ID, Client ID, Client Secret, and REST API address. To download a text file with all these credentials, click Download text. To copy these credentials to the clipboard, click Copy to clipboard.
When complete, click Close.
Deleting the integration
If you no longer need some integration, you can delete it. After the removal, the issued certificates for the integration will be no longer valid, so you cannot use them for further data management on the InCountry platform.
Open the environment.
Click the Integrations block.
On the list with integrations, locate the integration you want to delete.
Click the Delete Integration icon.
On the Delete Integration page, enter the verification code.
Once entered, click Delete.