Two-Factor Authentication (2FA) for CyberArk PVWA
        
        Two Factor Authentication (2FA) or Multifactor Authentication is the process of the authentication in which you have to provide two factors to gain the access. First Factor is the one that you know username and password and Second factor is what you might have as unique like a phone (For OTP) or Fingerprint. This additional layer prevents the unauthorized person from accessing the resources even if they know your username and password. miniOrange provides 15+ authentication methods and solutions for various use cases.
        
	Connect with External Source of Users
	miniOrange provides user authentication from various external sources, which can be Directories (like ADFS, Microsoft Active Directory, OpenLDAP, AWS etc), Identity Providers (like Microsoft Entra ID, Okta, AWS), and many more. You can configure your existing directory/user store or add users in miniOrange.
         
      
      
      
        
              
                
                    
                       
                    miniOrange 
 Authenticator App
                     
                    
                 
               
             
                
                   
                      
                     Google 
 Authenticator App
                    
                   
                 
              
              
                
                    
                       
                      Authy 2-Factor 
Authentication App
                     
                    
                 
               
                  
                     
                        
                            
                           Microsoft 
Authenticator App
                         
                        
                      
                   
         
       
        
        Follow the Step-by-Step Guide given below for CyberArk Password Vault Web Access Single Sign-On (SSO)
        1. Configure CyberArk PVWA in miniOrange
 
  - Login into miniOrange Admin Console. 
- Go to Apps and click on Add Application button.

  - In Choose Application, select SAML/WS-FED from the application type dropdown.

  - Search for CyberArk PVWA in the list, if you don't find CyberArk PVWA in the list then, search for custom and you can set up your application in Custom SAML App.

        
            
              | SP Entity ID or Issuer: | <Enter Issuer Name> | 
            
              | ACS URL: | <Enter ACS URL> | 
            
              | Name ID: | E-mail Address | 
            
              | NameID format: | urn:oasis:names:tc:SAML:2.0:nameid‑format:emailaddress | 
          
          - Click Next, now in the Attribute Mapping configure the following attributes as shown in the image below.
          
          - To upload respective app logo for a Custom SAML App, click on Upload Logo tab.

          - Click on Save.
- Your application is saved successfully. Now click on the Select button against your newly created application. Go to Metadata.
          
          - On the Metadata page - 
 
 1. If you want to use miniOrange as User-Store i.e., your user identities will be stored in miniOrange then download the metadata file under the heading 'INFORMATION REQUIRED TO SET MINIORANGE AS IDP'.
 
 2. If you want to authenticate your users via any external Identity Provider like Active Directory, Okta, OneLogin, Google, Apple ID, etc then download the Metadata file under the heading 'INFORMATION REQUIRED TO AUTHENTICATE VIA EXTERNAL IDPS'.
          
          - Then click on Download Metadata.
 
        
2. Configure SSO in CyberArk Password Vault Web Access
        
        - Open the c:\inetpub\wwwroot\PasswordVault\web.config file from the server hosting the CyberArk Password Vault Web Access (PVWA).
- Search for the <appSettings> section.
- Add the following lines:
            - <add key="IdentityProviderLoginURL" value="<IdentityProviderLoginURL>" />
- <add key="IdentityProviderCertificate" value="<IdentityProviderCertificate>" />
- <add key="Issuer" value="PasswordVault" />. The value of the Issuer must be identical to the Audience defined in the IdP. The default value for this parameter is PasswordVault.

          - Save the web.config file.
- Restart Internet Information Services (IIS).
- Login to CyberArk PVWA as an administrator.
- Navigate to Administration > Options > Access Restrictions.
- Add a new AllowedReferrer: Use BaseUrl value from miniOrange IDP.
- Click Apply.
 
          
          - Select Authentication Methods > saml.
- Enter Display Name and set Enabled to Yes.
- Use LogoffUrl value from miniOrange IDP.
- Click Apply and OK.
3. Configure 2FA for CyberArk Password Vault Web Access
        
        
        4. Login with miniOrange
        
          - Go to your CyberArk PVWA Domain. It will redirect you to miniOrange Single Sign-On Service  console.
          
 
          
          - Enter your miniOrange login credentials and click on Login.
- Since we have Two-factor authentication(2FA) enabled, you will be prompted to register for it. It's a one time process.
- Configure your basic details.
 
          
          - Configure any authentication method of your choice.
 
          
          - After successful registration, you will be logged in to your CyberArk PVWA account.
- Now we have Two-factor authentication enabled.
- To verify your Two-factor authentication(2FA) configuration, go to your CyberArk PVWA Domain. You will be redirected to miniOrange login  console. 

          - Enter your login credentials, and click on login. It will prompt to verify yourself against the configured 2fa method. 
 e.g. If you have configured OTP over SMS, after login into CyberArk PVWA it will prompt for OTP.

          - Enter the OTP received in your phone, after successful 2fa verification, you will be redirected to the CyberArk PVWA dashboard.
5. Adaptive Authentication with CyberArk PVWA
            
A. Restricting access to CyberArk PVWA with IP Configuration
  You can use adaptive authentication with CyberArk PVWA Single Sign-On (SSO) to improve the security and functionality of Single Sign-On. You can allow a IP Address in certain range for SSO or you can deny it based your requirements and you can also challenge the user to verify his authenticity. Adaptive authentication manages the user authentication bases on different factors such as Device ID, Location, Time of Access, IP Address and many more.
  You can configure Adaptive Authentication with IP Blocking in following way :
  - Login to Self Service Console >> Adaptive Authentication >> Add Policy.

  - Add a Policy Name for your Adative Authentication Policy.
- Select Action for Behavior Change, click the Edit link, and then choose the appropriate Action and Challenge Type for the user from that section.

  Action for behavior Change Options :
 
  
   
     | Attribute | Description | 
   
    | Allow | Allow users to authenticate and use services if Adaptive authentication condition is true. | 
   
    | Deny | Deny user authentications and access to services if Adaptive authentication condition is true. | 
   
    | Challenge | Challenge users with one of the three methods mentioned below for verifying user authenticity. | 
  
  Challenge Type Options :
 
  
   
     | Attribute | Description | 
   
    | User second Factor | The User needs to authenticate using the second factor he has opted or assigned for such as 
        OTP over SMSPUSH NotificationOTP over Email and, many more. | 
    
      | KBA (Knowledge-based authentication) | The System will ask the user for 2 of 3 questions he has configured in his Self-Service Console. Only after the right answer to both questions is the user allowed to proceed further. | 
    
      | OTP over Alternate Email | User will receive an OTP on the alternate email they have configured through the Self Service Console. Once the user provides the correct OTP, they are allowed to proceed further. | 
  
  - Now click Edit option from the IP Configuration section to configure custom IP range.
- Select Add IP if the User's IP Address is not in the configured list.
- Specify the IP Address that you want to whitelist. For the IP Range other than the whitelisted one, you can select the above setting to reflect.
- Choose either allow or deny by selecting the corresponding option from the dropdown.
- If a user tries to login with the whitelisted IP address, they will always be allowed access.
- We support IP address range in three formats i.e., IPv4, IPv4 CIDR, and IPv6 CIDR. You can choose whichever is suitable for you from the dropdown menu.
- You can add multiple IPs or IP ranges by clicking the + Add IP button.

  - Once the changes are made, scroll down to the end and click on Save.
B. Adaptive Authentication with Limiting number of devices
  Using Adaptive Authentication you can also restrict the number of devices the end user can access the Services on. You can allow end users to access services on a fixed no. of devices. The end users will be able to access services provided by us on this fixed no. of devices.
  You can configure Adaptive Authentication with Device Restriction in following way
  - Login to Self Service Console >> Adaptive Authentication >> Add Policy.
- Add a Policy Name for your Adaptive Authentication Policy. 
- Select your Action for behavior Change and Challenge Type for user from the Action for behavior Change Section.

  - On the Add Policy tab, go to the Device Configuration section and click the Edit button.
- Enter the Number of Device Registrations Allowed as per your requirement. (2-3 devices are recommended.)
- Choose Action if number of devices exceeded (This will override your setting for Action for behavior Change.)
    - Challenge: The user needs to verify himself using any of the three methods mentioned in table in step 5.1
- Deny : Deny users access to the system
- Enable Mobile Device Restriction to block logins from mobile devices. This ensures all login attempts from mobile devices will be declined.
- Enable MAC Address Based Restriction if you want to restrict access based on device MAC address.

  - Scroll down to the bottom of the page and click on Save.
C. Add Adaptive Authentication policy to CyberArk PVWA
  - Login to Self Service Console >> Policies >> Add Login Policy.
- Click on Edit icon option for predefined app policy.

  - Set your policy in the Policy Name and select Password as First Factor.
- Enable Adaptive Authentication on Edit Login Policy page and select the required restriction method as an option.
- From Select Login Policy dropdown select the policy we created in last step and click on Submit.

  
D. Notification and Alert Message.
How to add a trusted Device
  - When End-user log in to the self service console after the policy for device restriction is on, he is provided the option to add the current device as a trusted device.
 External References