Jumpcloud (SAML)

JumpCloud provides Directory-as-a-Service ↗ to securely connect user identities to systems, apps, files, and networks. Cloudflare Access integrates with JumpCloud using the SAML protocol. This documentation from JumpCloud ↗ can help you configure applications within your JumpCloud deployment.

These steps focus on requirements specific to Cloudflare Zero Trust.

Set up Jumpcloud SAML

To set up JumpCloud SAML as your identity provider:

1. Generate a SAML certificate.

   Tip: JumpCloud requires that you provide your own certificates for signing SAML assertions. Self-signed certificates are acceptable.

   If you do not have a certificate, this command generates one using OpenSSL:

   openssl genrsa -out samlidp.key 2048 ; openssl req -new -x509 -sha256 -key samlidp.key -out samlidp.crt -days 1095

   Generating RSA private key, 2048 bit long modulus
   .................................................................................+++++
   ......................+++++
   e is 65537 (0x010001)

   When asked to enter a Distinguished Name or a DN to incorporate into your certificate request, you can leave some of these fields blank. Some fields have a default value. Enter a dot (.) in the field to leave it blank. For example:

   -----
   Country Name (2 letter code) [AU]:.
   State or Province Name (full name) [Some-State]:.
   Locality Name (eg, city) []:.
   Organization Name (eg, company) [Internet Widgits Pty Ltd]:.
   Organizational Unit Name (eg, section) []:.
   Common Name (e.g. server FQDN or YOUR name) []:JumpCloud SAML IdP
   Email Address []:

2. In JumpCloud, select Applications in the left-side menu.

3. Select the + icon at the top-left of the screen to add an application.

4. Choose the SAML option in Application Types.

5. Enter an application name in Display Label.

6. Enter an IdP entity in the IDP IDENTITY ID field.The IdP entity can be anything, but must be unique. We suggest you reference something identifiable, such as your Cloudflare team domain (https://<your-team-name>.cloudflareaccess.com/).

7. At the prompt, enter the IdP private key and IdP certificate you previously generated.

8. Set both the SP entity ID and ACS URL to the following callback URL:

   https://<your-team-name>.cloudflareaccess.com/cdn-cgi/access/callback

   You can find your team name in Zero Trust under Settings > Custom Pages.

9. Under SAML SUBJECT NAMEID, choose email.

10. Set the SAML SUBJECT NAMEID FORMAT to:

    urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress

11. Under USER ATTRIBUTES enter email for the name and email for the value.

12. Leave other settings at default.

13. Select save. Remember to assign this application to users or groups.

    

14. In Zero Trust, go to Settings > Authentication.

15. Under Login methods, select Add new.

16. Select SAML.

17. Input a Name, a Single Sign on URL, IdP Entity ID or Issuer URL, and Signing Certificate.

18. Select Save.

To test that your connection is working, go to Authentication > Login methods and select Test next to the login method you want to test.

Example API configuration

{
  "config": {
    "issuer_url": "jumpcloud",
    "sso_target_url": "https://sso.myexample.jumpcloud.com/saml2/cloudflareaccess",
    "attributes": ["email", "name", "username"],
    "email_attribute_name": "",
    "sign_request": false,
    "idp_public_cert": "MIIDpDCCAoygAwIBAgIGAV2ka+55MA0GCSqGSIb3DQEBCwUAMIGSMQswCQYDVQQGEwJVUzETMBEG\nA1UEC.....GF/Q2/MHadws97cZg\nuTnQyuOqPuHbnN83d/2l1NSYKCbHt24o"
  },
  "type": "saml",
  "name": "jumpcloud saml example"
}