Add an authenticator
You add authenticators so that you can add them to authentication policies. An authenticator typically defines one authentication method, such as a password (for example, a
Cylance
console password) or a connection to a third-party for authentication like Active
Directory
, Okta
, or Ping Identity
. You add them to authentication policies to specify the types of authentication that administrators must complete to sign in to the Cylance
console and users must complete to activate Cylance Endpoint Security
apps or agents (for example, the CylancePROTECT Mobile
app or CylanceGATEWAY
). You can combine multiple authenticators in an authentication policy to provide multiple authentication steps. For example, you can combine the Enterprise authenticator with a one-time password prompt in a policy to require users to authenticate with both their work or Cylance
console password and a one-time password.If you add a SAML authenticator, download a copy of the signing certificate for your IDP.
- On the menu bar, clickSettings > Authentication.
- ClickAdd Authenticator.
- In theAuthenticator Typedrop-down list, select one of the following authenticators:ItemDescriptionAzure(SAML)Select this option if you want users to enter theirAzurecredentials. Do the following:
- Enter a name for the authenticator.
- If you want users to validate their email with a one-time code when they log in for the first time, turn onValidation required. The code is sent to the email address that is associated with the user in your tenant.
- In theLogin request URLfield, enter the Login URL that is specified in the app registration single sign-on settings for your identity provider. For example, in theAzurePortal, go to Enterprise Application > CylancePROTECT application > Properties > Single Sign-On Settings > Login URL.
- In theIDP signing certificatefield, paste the the body of the signing certificate that you downloaded, including the Begin Certificate and End Certificate lines.When you copy and paste the body of the certificate, make sure that you don't alter any line breaks or the format of the certificate information.
- In theSP entity IDfield, enter theIdentifier (Entity ID)that is used in the SAML configuration inAzure. This field is required, and the value that you enter must match the Identifier (Entity ID) inAzure.
- Specify any other optional settings.
- ClickSave.
Custom (SAML)Select this option if you want users to enter custom credentials. Do the following:- Enter a name for the authenticator.
- If you want users to validate their email with a one-time code when they log in for the first time, turn onValidation required.
- In theLogin request URLfield, enter the identity provider's single sign-on URL.
- In theIDP signing certificatefield, paste the the body of the signing certificate that you downloaded, including the Begin Certificate and End Certificate lines.When you copy and paste the body of the certificate, make sure that you don't alter any line breaks or the format of the certificate information.
- Specify any other optional settings.
- ClickSave.
Cylance Administrator PasswordSelect this option if you want users to enter theirCylanceconsole credentials. Do the following:- Enter a name for the authenticator.
- ClickSave.
Deny AuthenticationSelect this option if you want to use an authentication policy to prevent users or groups of users from accessing theCylanceconsole or another service. You can add another policy or an app exception to allow access to a subset of users.- Enter a name for the authenticator.
- ClickSave.
DuoMFASelect this option if you want users to authenticate usingDuomulti-factor authentication.Before you addDuoas an authenticator, you should create an Auth API application. For instructions, see the information fromDuo.Do the following:- Enter a name for the authenticator.
- In theDUO MFA Configurationsection, enter the API hostname, Integration key, and Secret key. You can find this information on the Applications tab in your organization'sDuoaccount. For more information, see the Duo documentation.
EnterpriseSelect this option if you want users to authenticate using their credentials forActive Directory, LDAP, or. The credentials that a user will use depends on the account type that is the source for their user account in the console. Do the following:myAccount- Enter a name for the authenticator.
- ClickSave.
FIDOSelect this option if you want users to register aFIDO2device and use it verify their identity. Supported device types include smartphones, USB security keys, orWindows Hello.- Enter a name for the authenticator.
- ClickSave.
WhenFIDOis the first factor of authentication and a user registers a device for the first time, a one-time password is also sent to the email address that they use to sign in. WhenFIDOis used as a second factor in a policy, a one-time password isn’t required when a user registers a device for the first time.For information about how to remove registered devices from a user account, see Remove a registeredFIDOdevice for a user account in the Administration content.Integrated Directory (Active Directory/Azure AD/LDAP)Select this option if you want users to enter theirActive Directorypassword. If you select this option, yourCylance Endpoint Securitytenant must have a connection to the company directory instance. For more information, see Linking to your company directory. Do the following:- Enter a name for the authenticator.
- ClickSave.
IP AddressSelect this option if you want to restrict users’ access based on their IP address. You can create multiple IP address authenticators and use them to manage access for different groups, but you can only assign one IP address authenticator in a policy.- Enter a name for the authenticator.
- In theIP address rangesfield, specify one or more IP addresses, IP ranges, or CIDRs. Separate entries with a comma.
- ClickSave.
Local AccountSelect this option if you want users to enter theirBlackBerry Online Account() credentials. Do the following:myAccount- Enter a name for the authenticator.
- ClickSave.
OktaMFASelect this option if you want users to authenticate usingOkta. Do the following:- Enter a name for the authenticator.
- In theOkta MFA Configurationsection, enter the Auth API Key and the Auth Domain.
- ClickSave.
Okta(OIDC)Select this option if you want users to authenticate usingOkta. Do the following:- In the drop-down list belowOkta, selectOIDC.
- Enter a name for the authenticator.
- In theIdentity Provider Clientsection, enter the OIDC discovery document URL, the Client ID, and the Private key JWKS.
- ClickSave.
Okta(SAML)Select this option if you want users to enter theirOktacredentials. Do the following:- In the drop-down list belowOkta, selectSAML.
- Enter a name for the authenticator.
- If you want users to validate their email with a one-time code when they log in for the first time, turn onValidation required.
- In theLogin request URLfield, enter the identity provider's single sign-on URL.
- In theIDP signing certificatefield, paste the the body of the signing certificate that you downloaded, including the Begin Certificate and End Certificate lines.When you copy and paste the body of the certificate, make sure that you don't alter any line breaks or the format of the certificate information.
- Specify any other optional settings.
- ClickSave.
OneLogin(OIDC)Select this option if you want users to authenticate usingOneLogin. Do the following:- In the drop-down list belowOneLogin, selectOIDC.
- Enter a name for the authenticator.
- If you want users to validate their email with a one-time code when they log in for the first time, turn onValidation required.
- In theOneLogin Configurationsection, enter the OIDC discovery document URL, the Client ID, Client Secret, and Authentication Method.
- ClickSave.
OneLogin(SAML)Select this option if you want users to enter theirOneLogincredentials. Do the following:- Enter a name for the authenticator.
- If you want users to validate their email with a one-time code when they log in for the first time, turn onValidation required.
- In theLogin request URLfield, enter the identity provider's single sign-on URL.
- In theIDP signing certificatefield, paste the the body of the signing certificate that you downloaded, including the Begin Certificate and End Certificate lines.When you copy and paste the body of the certificate, make sure that you don't alter any line breaks or the format of the certificate information.
- Specify any other optional settings.
- ClickSave.
One-Time PasswordSelect this option if you want users to enter a one-time password in addition to another type of authentication.Do the following:If you select this option, you must also add another authenticator to your authentication policy and rank it higher than the one-time password.- Enter a name for the authenticator.
- In theOne-Time Password Configurationsection, in the first drop-down list, select a number of intervals in the drop-down list. Any code within the window is valid if it precedes or follows the expected code by the number of refresh intervals that you specify. The refresh interval is 30 seconds, and the default setting is 1.
- In theOne-Time Password Configurationsection, in the second drop-down list, specify the number of times that users can skip the OTP app setup and authenticate without entering a code.
Ping Identity(OIDC)Select this option if you want users to authenticate usingPing Identity.Do the following:- In the drop-down list belowPing, selectOIDC.
- Enter a name for the authenticator.
- In theIdentity Provider Clientsection, enter the OIDC discovery document URL, the client ID, and the private key JWKS.
- In theID token signing algorithmdrop-down list, select a signing algorithm.
- ClickSave.
Ping Identity(SAML)Select this option if you want users to enter theirPing Identitycredentials. Do the following:- In the drop-down list belowPing, selectSAML.
- Enter a name for the authenticator.
- If you want users to validate their email with a one-time code when they log in for the first time, turn onValidation required.
- In theLogin request URLfield, enter the identity provider's single sign-on URL.
- In theIDP signing certificatefield, paste the the body of the signing certificate that you downloaded, including the Begin Certificate and End Certificate lines.When you copy and paste the body of the certificate, make sure that you don't alter any line breaks or the format of the certificate information.
- Specify any other optional settings.
- ClickSave.
- ClickSave.