Creating a New Certificate
1
Filling Definition Information
Click the Create button from the Management → Secrets Management → Certificates screen. Fill in the information under Definition. Then click the New Certificate Definition button.
| Field | Description |
|---|---|
| Name | Name information of the created certificate. |
| Description | A description can be written to facilitate management related to the created certificate. |
2
Filling Certificate Configuration Information
Fill in the configuration information for the Certificate in the opened window. Then click the Apply button. The saved Certificate Definition is listed in the table opened under Configuration.
| Field | Açıklama |
|---|---|
| Environments (Environments) | The previously defined environment where the certificate will be used is selected. |
| Source Of Certificate (Source Of Certificate) | The source from which the certificate will be obtained. Three options are available: - Receive via HTTPS/LDAPS Connection - Import from File - Paste from Clipboard |
| URL | When the Receive via HTTPS/LDAPS Connection option is selected, the HTTPS or LDAPS URL connection address is entered in the URL field and the button next to it is clicked. |
| File (File) | When the Import from File option is selected, the file containing the certificate is selected by clicking the “Select File” button. |
| Certificate (Certificate) | When the Paste from Clipboard option is selected, this is the field where the certificate will be pasted. |
| Encoding Type (Encoding Type) | When the Paste from Clipboard option is selected, the encoding type of the pasted certificate is selected. Two options are available: - BASE64 - BASE64PEM |
| Alias | The alias information of the certificate is entered. |
| Content (Content) | This is the field where the content of the certificate is displayed. |
| Certificate (Certificate) | Obtained from the certificate. |
3
Save and Deploy
After completing the definition and configuration information, click the Save and Deploy button to deploy.
Certificate Editing
1
Clicking Edit Button
To edit an existing certificate, click the Edit button from that certificate’s menu.
2
Update or Cancel Operations
In the screen opened when you click the Edit field, you can perform update and cancel operations on the certificate.
3
Saving Changes
Click the Apply button to save the changes you made.
Updating Related JWKs
When a certificate is updated and the Save and Deploy button is clicked, if there are JWKs created from this certificate, the system automatically detects related JWKs and presents the user with options.When a certificate is updated, JWKs created from this certificate can also be automatically updated or the relationship can be disconnected.
JWK Connection Dialog
When a certificate is updated and related JWKs are detected, the following dialog opens:
- Title: “JWK Connection”
- Warning Message: “This Certificate is used in X JWK(s). What would you like to do?”
- Options:
- Update related JWKs: Ensures that changes in the certificate are reflected to related JWKs as well. When this option is selected, related JWKs are automatically updated when the certificate is updated.
- Update certificate only and disconnect: Updates the certificate but disconnects the relationship with JWKs. When this option is selected, the certificate is updated but JWKs remain in their previous state and the relationship is removed.
- Cancel: Cancels the operation and no changes are made.
Update Flow
1
Certificate Update
Edit the certificate information and click the Save and Deploy button.
2
Related JWK Check
The system checks for JWKs created from this certificate.
3
Dialog Display
If there are related JWKs, the JWK Connection dialog opens.
4
Making Selection
The user selects one of three options:
- Update: Update related JWKs as well
- Disconnect: Update only the certificate, disconnect the relationship
- Cancel: Cancel the operation
5
Confirmation Dialog
When Update or Disconnect is selected, a confirmation dialog opens. The user confirms the operation by entering the certificate name.
6
Completing Operation
After confirmation, the selected operation is performed and the certificate is updated.
Certificate Deletion
1
Clicking Delete Button
To delete an existing certificate, click the Delete button from that certificate’s menu.
2
Related JWK Check
The system checks for JWKs created from this certificate. If there are related JWKs, the JWK Connection dialog opens.
3
Deletion Options
If there are related JWKs, the following options are presented:
- Delete JWKS: Delete related JWKs as well
- Delete Disconnect: Delete only the certificate, keep JWKs (relationship is disconnected)
- Cancel: Cancel the operation
4
Confirmation Dialog
When Delete JWKS or Delete Disconnect is selected, a confirmation dialog opens. The user confirms the operation by entering the certificate name.
5
Confirming Deletion Operation
Click the Delete button again in the opened window to confirm.
Deleting Related JWKs
When a certificate is deleted, if there are JWKs created from this certificate, the system automatically detects related JWKs and presents the user with options.Deletion Flow
1
Certificate Deletion Request
Start the certificate deletion operation.
2
Related JWK Check
The system checks for JWKs created from this certificate.
3
Dialog Display
If there are related JWKs, the JWK Connection dialog opens.
4
Making Selection
The user selects one of three options: Delete JWKS, Delete Disconnect, or Cancel.
5
Confirmation Dialog
When Delete JWKS or Delete Disconnect is selected, a confirmation dialog opens. The user confirms the operation by entering the certificate name.
6
Completing Operation
After confirmation, the selected operation is performed and the certificate is deleted.
Certificate Export
1
Clicking Export Button
To export the certificate, click the Export button from that certificate’s menu.
Truststore
In the Truststore tab, digital certificates used in Apinizer and trusted root certificate authorities (CA) are listed.