FlashArray-Side Configuration Using the Pure FlashArray's GUI: Purity Versions Between 5.0.x and 5.2.x.

Directory Services on FlashArray

Audience
Public
Product
FlashArray > FlashArray Directory Services
FlashArray
FlashArray > Purity//FA
Source Type
Documentation

Note: Initial configuration of Directory Services must be done as the local pureuser account. To do this, access the Purity GUI as the local pureuser account and navigate to the Directory Service configuration section.

  1. Click from the System tab, click Directory Services from the Users menu in the left panel.
  2. Click on Edit. A dialog displays.

  3. Fill in the blanks with the information gathered from Active Directory.

Field

Input

Enabled

Select the check box to leverage the directory service to perform user account and permission level searches.

URI

Enter the universal resource identifier (URI)

The URI must include a URL scheme (ldap, or ldaps for LDAP over SSL), the hostname, and the domain. You can optionally specify a port.

For example, ldap://ad.company.com configures the Active Directory server with the hostname 'ad' in the domain 'company.com' while specifying the unencrypted LDAP protocol.

Note: If you define more than one DC URI here, the URL scheme and domains must match exactly. No mixing of domains is allowed, including subdomains.

Acceptable: ldap://mydc.mydomain.com,ldap://mydc2.mydomain.com,ldap://mydc3.mydomain.com

Not acceptable: ldap://mydc.mydomain.com,ldap://mydc2.subdomain.mydomain.com,ldap://mydc3.mydomain2.com

Not acceptable: ldap://mydc.mydomain.com,ldaps://mydc2.mydomain.com,ldaps://mydc3.mydomain.com

Note: The URI entry auto-fills the Base DN which is case sensitive. Please be sure to match the case used in AD.

Base DN

Enter the base distinguished name (DN) of the directory service. The Base DN is built from the domain and should consist only of domain components (DCs). For example, for ldap://ad.storage.company.com, the Base DN would be:

“DC=storage,DC=company,DC=com” If you leave the field blank, the Base DN will be derived from the URI.

Note: The case must match the case used in AD.

Bind User

Enter the username for the account that is used to perform directory lookups, this should be your LDAP reader account that is not tied to any actual user.

Typically speaking, the bind user will be low-level account in AD, and not tied to any actual user. Purity does not require any extra permissions for the Bind user and a non-privileged account with the default users will do for our requirements. However, if you use permissions / ACL's within your provider then the Bind user will require elevated permissions.

The password policy for the LDAP reader account should be set to never expire, and change should not be allowed. If the password were to expire or change, Windows users who would normally be able to authenticate with the FlashArray will lose access to the FlashArray using Directory Services. If the password were to change for the LDAP Reader account, the password would need to be set back to the way it was in AD, or updated in the Directory Service configuration to match the new password in AD.

Purity uses ldap to heartbeat between the FlashArray and the Domain Controller(s). If the ldap (bind user) account cannot connect to the Domain Controller(s) for any reason, a Warning Alert will be generated and logged.

Bind Password

Enter the password for the bind user account.

Note: If this password expires or changes, you will need to update it here.

Group Base

Enter the organizational unit (OU) path to the groups that are configured in Active Directory. Groups can be nested. In the following example, SANManagers contains the sub-organizational unit PureGroups:

OU=PureGroups,OU=SANManagers

All FlashArray configured group common names (CN) must exist in the same OU.

Note: Group Base is case sensitive and must match the case used in AD. When entering the groups, don't use quotations.

Array Admin Group

Enter the common name (CN) of the group of administrators that are allowed to perform every FlashArray operation. Array Admin Group administrators have the same privileges as pureuser.

Storage Admin Group

Enter the common name (CN) of the group of administrators that are allowed to perform FlashArray storage operations.

Read Only Group

Enter the common name (CN) of the group of users with read-only privileges on the FlashArray.

Note: DO NOT enter the same group name in more than one field. The permissions for the group will be locked down to the lowest level permissions.

Check Peer

Select the check box to validate the authenticity of the directory servers using the CA Certificate (TLS will be used to secure the connection).

When using ldap:// in the URI, this box has no effect.

CA Certificate

Enter the certificate of the issuing certificate authority. Only one certificate can be configured at a time, so the same certificate authority should be the issuer of all directory server certificates. The certificate should be PEM formatted (base64 encoded) and should not exceed 3000 characters in total length.

  1. Additional information and configuration is required for TLS support. If you want encrypted communication and have already enabled SSL on the AD server, setting the URI scheme to ldaps:// is adequate. However, if you also want server authentication, you need the PEM certificate of the AD server (base64 encoded x.509). Once SSL is enabled, the entire AD bind and query session is encrypted. Complete the below few steps to configure TLS support.
    1. Optional: To import the certificate, select “Edit."
    2. After selecting "Edit" a dialog box will open. Choose each DC one by one from the drop-down menu, you may then enter the cert info manually, or click on "Fetch from server" to auto-fetch the cert and then select "Set" at bottom of the dialog box to continue.

    The following is an example of completed fields.

  2. If using LDAPS, click Check Peer.

  3. If everything looks correct, click Save. To test it, click Test.

    View the test results:

  4. If all results return with green boxes, then the configuration is validated. If any boxes return red, an entry most likely needs editing to reflect accurately the information from Active Directory.
  5. Failed test results can also be a result of Pure not being able to access or talk to the Domain Controller. The ldap search from the FlashArray is being blocked from traversing AD. Is “Read Member Of” denied on any of the objects? If so, remove that restriction.
  6. If you run a test, and it fails, and you believe all entries in Directory Service are configured correctly, and Active Directory is configured correctly, please open a Support ticket with Pure Storage Support.
  7. After a completed successful test result, you may enable Directory Services.

  8. Click Save to complete the setup.