Initial setup
Before you enable RDL on the FlashArray, the array and the must establish a mutual trust relationship by validating their respective digitally signed certificates.
The following sections show how to generate and sign certificates for both the FlashArray and the KMIP connection pair on the . The FlashArray and the register both certificates and use them thereafter each time they establish a TCP/IP session secured by TLS.
Notes about certificates:
- Certificates used on the FlashArray must be PEM formatted (Base64 encoded).
- Intermediary certificates are not supported for use with KMIP.
- Using the Purity internal management certificate for KMIP configuration is not supported.
Use the FlashArray Command Line Interface (CLI) to complete the following steps:
Run the following purecert create CLI command to create a self-signed certificate:
Display the certificate with the following purecert list command.
Copy the displayed certificate for use in a later step.
Run the following purecert construct command to construct the CSR:
Perform the following steps:
- Copy the displayed CSR and paste it into a file editor.
- Save the file with either the .pem or .csr extension.
- Then, move the file by using SFTP or other means to the external storage device configured on the .
Log in to the application interface with the default Admin identities to complete the following tasks.
Log in to the application interface with the default Admin identities
Go to PKI > Certificate Authorities and select [ Add CA ] at the bottom of the page.
In the Certificate Authority window, enter a name for the certificate container, leave all other fields as the default values, and select [ OK ].
The certificate container you created now displays in the Certificate Authorities menu.
Right-click the certificate container and select Add Certificate > New Certificate.
On the Subject DN tab, set a Common Name for the certificate, such as System TLS CA Root.
On the Basic Info tab, change the Major Key to PMK and the key size to 4096. Leave all other settings as the default values.
On the V3 Extensions tab, select the Certificate Authority profile and select [ OK ].
The root CA certificate now displays under the previously created certificate container.
Go to PKI > Certificate Authorities.
Right-click the Root CA certificate and select Add Certificate > From Request.
In the file browser, select the FlashArray CSR.
Certificate information populates in the Create X.509 From CSR window.
Leave all settings exactly as they are and select [ OK ] to save.
The Common Name of the certificate must match the common name you entered in the purecert create command.
The signed FlashArray certificate now displays under the Root CA certificate in the CA tree.
Perform the following tasks:
- Generate a private key and construct a CSR.
- Sign the KMIP connection pair CSR.
- Export all certificates in the CA tree.
- Configure the KMIP connection pair to use the signed certificate and CA chain.
Log in to the application interface with the default Admin identities.
Go to Administration > Configuration > Network Options and go to the TLS/SSL Settings tab.
Select the Connection drop-down option and select the KMIP connection pair.
Enable the KMIP connection pair if it is not already enabled.
Uncheck the Use System/Host API SSL Parameters checkbox if it is selected.
In the User Certificates section, select [ Edit ] next to PKI Keys.
In the Application Public Keys window, select [ Generate ].
When prompted that SSL will not be functional until new certificates are imported, select [ Yes ] to continue.
In the PKI Parameters window, leave all fields set to the default values and select [ OK ].
The Application Public Keys window now shows that a PKI Key Pair is Loaded.
Select [ Request ].
In the Subject DN tab, select Classic from the Preset drop-down list and specify the hostname or IP address of the KMES in Common Name.
On the V3 Extensions tab, set the profile to TLS Server Certificate.
On the PKCS #10 Info tab, specify a save location and name for the CSR file and select [ OK ].
When prompted that the certificate signing request was successfully written to the specified location, select [ OK ].
Select [ OK ] again in the Application Public Keys window to finish.
Go to PKI > Certificate Authorities.
Right-click the Root CA certificate and select Add Certificate > From Request.
In the file browser, select the KMIP connection pair CSR.
Certificate information populates in the Create X.509 From CSR window.
Leave all settings exactly as they are and select [ OK ] to save.
The signed KMIP connection pair certificate now displays under the Root CA certificate in the CA tree.
Perform the following steps for each certificate in the certificate tree:
Right-click the certificates in the certificate tree and select Export > Certificate(s).
In the Export Certificate window, change the encoding to PEM and specify a save location for the file.
Log in to the application interface with the default Admin identities.
Go to Administration > Configuration > Network Options and go to the TLS/SSL Settings tab.
Select the Connection drop-down option and select the KMIP connection pair.
In the User Certificates section, select [ Edit ] next to Certificates.
In the Certificate Authority window, right-click the KMIP SSL CA X.509 certificate container and select [ Import ].
In the Import Certificates window, select [ Add ] at the bottom of the window.
In the file browser, select both the root CA certificate and the signed KMIP connection pair certificate, and select [ Open ].
The certificates now display in the Verified section of the Import Certificates window.
Select [ OK ] to save.
You now see Signed loaded next to Certificates in the User Certificates section of the Network Options window under the KMIP connection pair.
Select [ OK ] to save and finish.
The following sections provide instructions for the following tasks:
- Add a PKI identity provider configured with the TLS authentication mechanism.
- Create a role for FlashArray.
- Create an identity for FlashArray.
Log in to the application interface with the default Admin identities.
Go to Identity Management > Identity Providers.
Right-click anywhere in the window and select Add > Provider > PKI.
On the Info tab of the Identity Provider Editor window, specify a name for the Identity Provider and uncheck Enforce Dual Factor.
On the PKI Options tab, select [ Select ].
In the Certificate Selector window, expand the certificate tree you created for mutual authentication, select the CA certificate that signed the FlashArray and KMIP connection pair certificates, and select [ OK ].
Select [ OK ] to finish creating the PKI identity provider.
Right-click the identity provider you just created and select Add > Mechanism > TLS.
Othe Info tab, specify a name for the authentication mechanism.
On the PKI tab, leave all fields set to the default values.
Select [ OK ] to save.
Go to Identity Management > Roles and select [ Add ].
In the Info tab of the Role Editor window, set the Type to Application, the name to FlashArray, and Logins Required to 1.
On the Permissions tab, enable all permissions.
On the Advanced tab, set Allowed Ports to KMIP only.
Select [ OK ] to finish creating the role.
Go to Identity Management > Identities.
Right-click anywhere in the window and select Add > Client Application.
On the Info tab of the Identity Editor window, select Application for the storage location and specify FlashArray as the identity name.
On the Assigned Roles tab, select the role you created for FlashArray.
On the Authentication tab, remove the default API Key mechanism and select [ Add ].
In the Configure Credential window, select the TLS Certificate drop-down option in Type and select the Provider and Mechanism you created. Select [ OK ] to finish configuring the credential.
Select [ OK ] to finish creating the identity.