Integration with Buypass Go SSL
Key Manager Plus facilitates integration with Buypass Go SSL — the certificate authority (CA) that uses the Automatic Certificate Management Environment (ACME) protocol to provide secure SSL certificates free of cost. This integration with Buypass Go SSL helps you achieve an end-to-end life cycle management of Buypass Go SSL certificates installed on your domains from a single interface. This document discusses the steps you should follow to establish a connection with your Buypass Go SSL account, acquire, deploy, renew and perform all certificate management related operations from Key Manager Plus.
Before you proceed with the integration, complete the following step as a prerequisite:
Prerequisite
Add the following base URL and port as an exception in your firewall or proxy to ensure Key Manager Plus is able to connect to Buypass Go SSL's CA Services.
Production URL: https://api.buypass.com/acme/directory
Staging URL: https://api.test4.buypass.no/acme/directory
Port: 443
Follow the step-by-step procedure below to integrate Buypass Go SSL with Key Manager Plus:
- Create a Buypass Go SSL Account
- Raise a Certificate Request
- Buypass Go SSL Challenge Verification
- Procure and Save the Certificate
- Renew Certificates
- Revoke Certificates
- Delete Certificates
1. Create a Buypass Go SSL Account
To begin the process of requesting SSL certificates from Buypass Go SSL, you must create an account. This is a one-time process and can be done directly from the Key Manager Plus interface.
- To create a Buypass Go SSL account, Navigate to the SSL tab, click the ACME drop-down and select Buypass Go SSL.
- Click Manage. Under the Account tab, click New Registration.
- In the pop-up, enter an account name and a valid e-mail address. Choose Production or Staging, based on your requirement.
- Click the checkbox to accept the Buypass Go SSL Subscriber Agreement.
- Click Register. Now, an account with Buypass Go SSL is created.
Once your account is created, you can update the account email address, delete it from Key Manager Plus, or deactivate the account entirely. Please note that deleting the account only removes it from Key Manager Plus. Even if you delete the account here, it will still be active in the Buypass Go SSL portal. To add the same account back to Key Manager Plus, export the key and use the Add Account option with the same details used before.
However, if you select the Deactivate option while deleting the account, then the Buypass Go SSL account will be removed completely and you cannot add it back to Key Manager Plus with the same details.
Note: Only the administrator users can perform the above operation and only one Buypass Go SSL account can be created from Key Manager Plus.
2. Raise a Certificate Request
Once your Buypass Go SSL account is registered, you can proceed with raising certificate requests to the CA. To complete a certificate request, you will be presented with a challenge verification to fulfill in order to validate your domain and issue the certificate you have requested.
- Navigate to SSL >> Acme >> Buypass Go SSL.
- Click Certificate Request. Fill in the domain name, select the challenge type, choose the key algorithm, algorithm length, signature algorithm, keystore type, enter the keystore password and click Create.
- For dns-01 challenge type, you can choose and assign a DNS account from the drop-down if you have already configured your DNS credentials. This will be used for automatic challenge verification for all the domains specified in the request.
- Also, you have options to change the private key whenever the certificate is renewed.
- If you need to change the key, use New Key. This option will generate a new key every time the certificate is renewed.
- If you want to retain the same key on renewal, use the Same Key option.
- To use your own key, use the Import Key option. This key will be used for the first time when the certificate is generated and also for subsequent renewals.
To configure your DNS account, follow the below steps:
- Navigate to Buypass Go SSL >> Manage. Switch to the DNS tab.
- Here, you can add a maximum of one DNS account for each DNS provider supported. Key Manager Plus currently supports automatic challenge verification for Azure DNS, CloudFlare DNS, and Amazon Route 53 DNS, RFC2136 DNS update (nsupdate), GoDaddy DNS, and ClouDNS. Click Add.
- In the pop-up that opens, choose the DNS provider.
![buypass-3](https://www.manageengine.com/au/key-manager/help/images/buypass-3.png)
2.1 Azure DNS
- Provide the Subscription ID, which is available in the Overview page of the Azure DNS zone.
- Provide the Directory ID, which is available in Azure Active Directory >> Properties.
- If you have an already existing Azure application, provide its Application ID and Key.
- If not, follow the steps mentioned in this document to create the Azure application and key, and give the application access to the DNS zones for making API calls.
- Finally, enter the Resource Group Name, which is the group name in which you have created the DNS zone and click Save.
- Your DNS account details are saved and listed under Manage >> DNS.
2.2 Cloudflare DNS
- In the Email address field, specify the email address associated with the Cloudflare account.
- For Global API Key, use the Generate API key option in the domain overview page of the Cloudflare DNS to generate the key and paste the value in this field. Click Save.
- Your DNS account details are saved and listed under Manage >> DNS.
2.3 AWS Route 53 DNS
Generate and specify the Access Key ID and Secret associated with your AWS account. If you do not have an AWS account, create one and generate the Access Key ID and Secret by following the steps given below:
- Login to the AWS console and navigate to IAM Services >> Users. Click Add user.
- Provide the user name and select the access type as Programmatic access.
- Switch to the next tab, click Attach existing policies directly under Set Permissions and search for "AmazonRoute53FullAccess".
- Assign the policy that is listed and switch to the next tab. In the tags section, add appropriate tags (optional) and switch to the next tab.
- Review all the information entered and click Create user.
- The user account is created and subsequently, an access key ID and a secret is generated. Copy and save the key ID and secret in a secure location for it will not be displayed again.
- If you already have an AWS user account, you have to grant "AmazonRoute53FullAccess" permission to the user and generate the access key if the user doesn't have one. if the user account has an access key associated already, it is just enough to ensure the required permission is granted.
To grant the required permissions:
- Navigate to the Permissions tab, select the required user account and click Add Permission.
- Click Attach existing policies directly under Set Permissions and search for "AmazonRoute53FullAccess".
- Assign the listed policy and hit Save.
- To generate the access key,
- Select the particular user account and navigate to the Security Credentials tab.
- In the window that opens, click Create access key.
- An access key ID and a secret is generated. Copy and save the key ID and secret in a secure location as it will not be displayed again.
2.4 RFC2136 DNS Update
If you are using open source DNS servers such as Bind, PowerDNS etc., that support RFC2136 DNS update, follow the steps below to automate DNS-based domain control validation procedure using Key Manager Plus.
- Mention the DNS Server IP / Hostname represents the server name / IP address in which the DNS server is installed or running.
- These details are usually found in the server installation directory. For instance, in the case of Bind9 DNS server, you can find these in the file named.local.conf in the server installation directory.
- Provide the Key Secret, which is nothing but the key content found in the server installation directory.
- Provide a name for the key, and choose the signature algorithm.
- Click Save.
2.5 GoDaddy DNS
If you are using GoDaddy DNS for DNS validation, follow the steps below to automate DNS-based domain control validation procedure using Key Manager Plus:
Steps to Obtain GoDaddy API Credentials:
- Go to the GoDaddy developer portal and switch to the API keys tab.
- Log in to your GoDaddy account if you aren't logged in already.
- Once you log in, you will be redirected to the API keys page where you can create and manage API keys.
- Click Create New API key.
- Provide your application name, choose the environment type as Production and click Next.
- The API key and its secret is generated. Copy and save the secret in a secure location, as it will not be displayed again.
Now, in Key Manager Plus interface, follow the below steps to add GoDaddy DNS to Buypass Go SSL CA:
- Navigate to SSL >> Acme >> Buypass Go SSL and click Manage from the right most corner.
- Switch to the DNS tab and click Add. Choose GoDaddy from the DNS Provider drop-down.
- Enter the Key and Secret that was previously generated from the GoDaddy portal.
- Click Save.
2.6 ClouDNS
If you are using ClouDNS for DNS validation, follow the steps below to automate the DNS-based domain control validation procedure using Key Manager Plus:
Steps to Obtain ClouDNS API Credentials:
- Login to your ClouDNS account and go to Reseller API.
- If you have already created an API user id, you will find it under API Users. If not, click Create API to generate a new one.
- Click here to learn more about ClouDNS API Auth IDs.
Now, in the Key Manager Plus interface, follow the below steps to add ClouDNS to Buypass Go SSL CA:
- Navigate to SSL >> Acme >> Buypass Go SSL and click Manage from the right most corner.
- Switch to the DNS tab and click Add.
- Choose ClouDNS from the DNS Provider drop-down.
- Choose one of the following options: Auth ID, Sub Auth ID, Sub Auth User.
- Enter the chosen ClouDNS Auth ID, its respective Auth Password, and click Save.
2.7 DNS Made Easy
- Enter the name of your choice in the Name field.
- The Key and the Secret will be available in the DNS Made Easy webpage under Config >> Account Information. Enter those details in the respective fields.
- Now, click Save to save your DNS account details. The saved DNS details will be listed under Manage >>DNS.
Notes:
- One certificate can secure up to 5 domains. You can enter a maximum of 5 names in the 'domain name' field out of which the first name is considered as the common name and the rest are treated as Subject Alternative Names (SAN).
- Buypass Go SSL has a rate limit of 20 certificates every 7 days for base domains. It supports upto 5 requests every 7 days for obtaining duplicate certificates.
- Buypass Go SSL does not support wildcard certificates.
- Key Manager Plus integration with Buypass Go SSL supports encryption via RSA and EC algorithms.
- Key Manager plus supports http-01 and dns-01 based domain validations. Choose the challenge type based on your requirements.
- For dns-01 based domain validation, if you are using your configured DNS account for challenge verification, make sure that the status of the chosen DNS account is marked Enabled under Manage >> DNS.
- Option to change the private key currently works only with the RSA key algorithm.
3. Buypass Go SSL Challenge Verification
Key Manager Plus expedites domain validation through automatic verification of HTTP-01 and DNS-01 challenges (currently Azure, Cloudflare, Amazon Route 53, RFC2136 DNS update, GoDaddy DNS, ClouDNS). For the automation to take effect, you have to initially map the end-server details to Key Manager Plus, which is a one-time process.
3.1 Domain Validation through HTTP-01 Challenge Verification
For domain validation through http-01 challenge,
- A window opens displaying the challenge to be fulfilled.
- Click the Agent mapping icon.
- A pop up will open. If the domain server is a Linux machine, fill in the required details and click Save.
If the domain server is a Windows machine, download and install the Key Manager Plus agent for Windows server using the steps mentioned below:
- Downloading Key Manager Plus agent for Windows servers:
- The Key Manager Plus agent package is a zip file comprising of the necessary executables, configuration files required for automatic verification of Buypass Go SSL challenges through automatic domain validation. Unzip the folder and install the agent on your Windows domain server after download. To download the agent,
- Navigate to SSL >> Acme >> Buypass Go SSL tab, and click Manage button in the top right corner.
- Switch to the Windows agents tab.
- Download the Key Manager Plus agent from the top right corner of the window based on your server compatibility (32 bit or 64 bit).
Installing Key Manager Plus agents for Windows server:
- Open the command prompt and navigate to the Key Manager Plus installation directory.
- Execute the command 'AgentInstaller.exe start.'
To stop the agent and uninstall the Windows service,
- Open the command prompt and navigate to the Key Manager Plus installation directory..
- Execute the command 'AgentInstaller.exe stop.'
- If the domain server is a Windows machine, download and install the Windows agent on the domain server. Navigate to Manage >> Windows agents, download and install the agent on the domain server.
- Once, the above agent mapping settings are configured (agent mapping is a one-time configuration), Key Manager Plus automatically handles the verification of challenges presented by Buypass Go SSL.
After configuring agent mapping, click Pending on the pending requests and click Verify. The challenge is verified and certificate request is submitted to Buypass Go SSL CA.
3.2 Domain Validation through DNS-01 Challenge Verification
For DNS-01 challenge verification from Key Manager Plus,
- Switch to the Buypass Go SSL tab and click on the request status (Pending) corresponding to the certificate request.
- You'll be directed to a window that displays the DNS challenge value and TXT record.
- If you have already configured your DNS account details and have opted for DNS while creating the certificate request, you can assign the DNS account to the request.
- Select the request, choose Assign DNS from More top menu and select the required DNS account.
- In cases where you do not have a DNS account configured or have not opted for it when raising the certificate request, Key Manager Plus provides an option for automating DNS-01 challenge verification through Agent Mapping.
- Click on the Agent Mapping icon available to the left side of the request. Agent mapping is a one-time configuration.
Agent Mapping
- In the Deploy window that opens, carry out the following operations to map and save your end-server details in Key Manager Plus.
- Choose your DNS provider. For Azure DNS, provide the required details—subscription ID, directory ID, application ID, application key and resource group name.
- For Cloudflare DNS, enter the email address associated with your Cloudflare account and the Global API key.
- For Amazon Route 53 DNS, enter the Access Key ID and Secret associated with your AWS account.
- Enable the Deploy Certificate check-box to automate deployment of the certificate to their corresponding end-servers after domain validation and after successive renewals.
- For Linux end-servers provide the required details, while for Windows end-servers download and install the Windows agent using the same procedure as mentioned for http-01 challenge.
- After filling in the details, click Save. The end-server details are successfully mapped and stored in Key Manager Plus, which you can view or edit from Manage >> Deploy tab.
![buypass-5](https://www.manageengine.com/au/key-manager/help/images/buypass-5.png)
Notes:
- You can request and acquire certificates only for public domains using Buypass Go SSL integration.
- The handling of challenges can also be done manually without automation. Copy and paste the challenge values / text records manually in your domain server. Then in the Key Manager Plus server, navigate to Pending Requests page and click Verify. The challenge is verified and certificate is issued.
- Key Manager Plus automates challenge verification using DNS for a certificate request only when Agent mapping is not available. Challenge verification is automated through agents, if agent details are available in Manage >> Deploy tab.
- Currently, Key Manager Plus agents are only available for Windows servers.
- For RFC2136 DNS update, if you have opted Global DNS configuration, the domain name itself acts as the zone name (Global DNS configuration is possible only if you are using the same Key Secret for all zones). Whereas, if you have opted domain-agent mapping, you have to provide the Zone name, Key Name, and Key Secret for each domain separately.
4. Procure and Save the Certificate
On successful verification, Buypass Go SSL issues the requested certificate.
- The window automatically redirects to a page which displays the certificate and its status (status is marked Available, if the challenge verification is successful and Failed if the challenge verification fails).
- Click the Available button to save the certificate in Key Manager Plus repository, e-mail or export it.
- If the challenge fails, click New challenge to obtain another set of challenges and repeat the above process.
- On saving, the certificate gets added to the Key Manager Plus repository which can be viewed from the SSL >> Certificates tab.
5. Renew Certificates
Certificates issued by Buypass Go SSL have a life-time of 180 days after which they are not valid.
Certificate renewals can be carried out manually or automatically through automatic domain validation. To renew a certificate manually,
- Navigate to SSL >> Acme >> Buypass Go SSL.
- Select the certificate that you want to renew and click Renew Certificate button.
- The certificate is renewed and the Certificate Status bar displays Renewed.
- Click on it to save the renewed version of the certificate to KMP certificate repository.
Note:
The certificate should be saved after renewal in order to be updated in the certificate repository. Else, only the old version of the certificate will continue to remain in repository.
Automatic Renewals through Automatic Domain Validation
If agent mapping had been configured, the certificate renewal process is done automatically without manual intervention. All the certificates in your organization procured from Buypass Go SSL is automatically renewed 15 days before its expiry and a notification is sent to the account holder's e-mail address.
Note:
Automatic renewals are applicable only for those certificates saved in Key Manager Plus repository. i.e., after procuring a certificate from Buypass Go SSL, you have to save it in order for the automatic renewal to take effect.
6. Revoke Certificates
Revoking a certificate renders the certificate invalid and immediately removes the HTTPS from the website.
To revoke a certificate,
- Navigate to SSL >> Acme >> Buypass Go SSL tab.
- Select a certificate you want to revoke and click Revoke Certificate.
- The certificate is revoked and is no longer valid.
![buypass-6](https://www.manageengine.com/au/key-manager/help/images/buypass-6.png)
7. Delete Certificates
Deleting a certificate removes the certificate from Key Manager Plus repository, but the certificate still remains valid.
To delete a certificate,
- Navigate to SSL >> Acme >> Buypass Go SSL tab.
- Select the certificate you want to delete and click More >> Delete.
- The certificate is deleted from the KMP database.