Netskope Help

Configure XenMobile for iOS On-Demand VPN

To configure XenMobile for iOS on-demand VPN:

  1. Log in to your XenMobile account (https://xms.bowlins.com:4443). Under Certificate Management, go to Settings > PKI Entities, click Add, and then select Microsoft Certificate Services Entity. This will be used during the new Credential Provider setup later in this procedure.

    XenMobilePKIentities.jpg
  2. For General Information, enter these parameters:

    • Name: Enter a unique name for this entity.

    • Web enrollment service root URL: Enter the Root URL for your account. For example, https://RootCA-URL/certsrv.

    • certnew.cer Page Name: Leave the default setting.

    • certfnsh.asp: Leave the default setting.

    • Authentication type: Client Certificate.

    • SSL client certificate: Import the user certificate that will be used to issue the XenMobile client certificate.

    When finished, click Next.

  3. For Templates, click Add, enter the name of the template created when configuring the Microsoft certificate, and then click Save. When finished click Next.

  4. Skip the HTTP Parameters and click Next.

  5. For CA Certificates, select the root CA that corresponds to your environment, which is part of the chain imported from the XenMobile client certificate. If no certificate is present, click Import certificate to add the CA certificate, and then select it. When finished, click Save.

  6. After creating a PKI entity, you need to add a credential provider. Under Certificate Management, go to Settings > Certificate Management > Credentials Providers and click Add to create a new credential provider.

    XenMobileSettings.jpg
  7. On the General page, enter these parameters:

    XenMobileCredentialProvider1.jpg
    • Name: Enter a unique credential provider name.

    • Issuing entity: Select the Microsoft Certificate Services Entity you created in step 2.

    • Issuing method: Sign.

    • Templates: Select the template you created in step 3.

    When finished, click Next.

  8. On the Certificate Signing Request page, enter these parameters:

    XenMobileCredentialProvider2.jpg
    • Key algorithm: RSA

    • Key size: 2048

    • Signature algorithm: SHA1withRSA

    • Subject name: Enter CN=$user.mail,emailAddress=$user.mail,OU=<Organization ID from the Netskope UI>,O=Citrix Systems.

    When finished, click Next.

  9. On the Distribution page, enter these parameters:

    XenMobileCredentialProvider3.jpg
    • Issuing CA certificate: Select your certificate from the dropdown list. To import your certificate, click Import CA certificate.

    • Select distribution mode: Select Prefer centralized: Server-side key generation.

    When finished, click Next.

  10. On the Revocation XenMobile page, enter these parameters:

    XenMobileCredentialProvider4.jpg
    • Revoke issued certificates: None of these options should be enabled.

    • Send notification: Off.

    • Revoke certification on PKI: Off.

    When finished, click Next.

  11. On the Revocation PKI page, make sure Enable external revocation checks is Off.

    XenMobileCredentialProvider5.jpg

    When finished, click Next.

  12. On the Renewal page, enter these parameters:

    XenMobileCredentialProvider6.jpg
    • Renew certificates when they expire: On.

    • Renew when the certificate comes within: 30 (days of expiration).

    • Send notification: Off.

    • Notify when the certificate nears expiration: Off.

    When finished, click Save.

  13. Now configure your credentials for Device Policies. Go to Configure > Device Policies and click More to expand the options. Under Security, click Credentials.

  14. Make sure iOS is the only platform selected, and then enter a unique Policy Name.

    XenMobileCredentailsPolicy1.jpg

    When finished, click Next.

  15. Enter these parameters:

    XenMobileCredentailsPolicy2.jpg
    • Credential type: Credential Provider.

    • Credential provider: Select the Netskope credential provider (you created in step 3 above).

    • Remove policy: Select date.

    • Allow user to remove policy: Always.

    When finished, click Assignment in the left panel.

  16. For Choose delivery groups, select AllUsers.

    XenMobileCredentialsPolicy3.jpg

    When finished, click Save.

  17. Now create a VPN policy. Go to Configure > Device Policies, click Add, and then click VPN.

  18. Make sure iOS is the only platform selected, and then enter a unique VPN policy name.

    XenMobileVPNpolicy1.jpg

    When finished, click Next.

  19. Make sure iOS is the only platform selected, and then enter these parameters:

    XenMobileVPNpolicy2.jpg
    • Connection name: Enter a unique connection name.

    • Connection type: IPSec.

    • Server name or IP address: Enter the VPN Server Name from the Create VPN Configuration section in the Netskope UI (Settings > Security Cloud Platform > Netskope Client > MDM Distribution).

    • User account: Enter an optional user account name.

    • Authentication type for the connection: Certificate.

    • Identity credential: Select the Credentials Policy (you created in step 11 above).

    • Prompt for PIN when connecting: Off.

    • Enable VPN on demand: On.

    • Next, enter the On-Demand Rules parameters:

      XenMobileVPNpolicy3.jpg
      • On-Demand Rules: EvaluateConnection.

      • InterfaceTypeMatch: Unspecified.

    • Next, enter the Action Parameters:

      XenMobileVPNpolicy4.jpg
      • ActionParameters:Domains: Add on-demand domains (like app.box.com).

        Tip

        If you want to add multiple on-demand domains at once instead of adding them one by one, create an XML file with on-demand domains as shown below, and then paste the code in the OnDemandRules:XML content field.

        <array>
                    <dict>
                      <key>Action</key>
                      <string>EvaluateConnection</string>
                      <key>ActionParameters</key>
                      <array>
                        <dict>
                          <key>Domains</key>
                          <array>
                            <string>.salesforce.com</string>
                            <string>login.salesforce.com</string>
                            <string>app.box.com</string>
                          </array>
                          <key>RequiredURLStringProbe</key>
                 <string>http://addontemp.dp.local/dlr/mac/x1bgjyzwNbwo2u</string>
                          <key>DomainAction</key>
                          <string>ConnectIfNeeded</string>
                        </dict>
                      </array>
                    </dict>
                  </array>
        
      • ActionParameters:DomainAction: ConnectIfNeeded.

      • RequiredURLStringProbe: Enter an HTTP or HTTPS URL to probe.

    • Next, add the Proxy parameters:

      XenMobileVPNpolicy6.jpg
      • Proxy configuration: Automatic.

      • Proxy server URL: Enter the PAC URL from the Create VPN Configuration section in the Netskope UI (Settings > Security Cloud Platform > Netskope Client > MDM Distribution).

      • Remove policy: Select date.

      • Allow user to remove policy: Always.

  20. Click Assignment in the left panel, and enter these parameters:

    • Choose delivery groups: AllUsers.

    • Expand the Deployment Schedule section to see these options.

      XenMobileVPNpolicy7.jpg

      Deploy: On

    • Deployment schedule: Now.

    • Deployment condition: On every connection.

    • Deploy for always-on connections: On.

  21. When finished, click Save.

The configuration for XenMobile on-demand VPN is complete. Install the Citrix Secure Hub iOS App on your device, and then after that you can perform the server login, user login, and so on to register the device. Refer to the Citrix product documentation for more information.