-
Notifications
You must be signed in to change notification settings - Fork 5.5k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
[Access for SaaS] Braintree SAML tutorial (#15575)
* create tutorial and fix weights * Apply suggestions from code review Co-authored-by: Patricia Santa Ana <[email protected]> * implement suggested edit --------- Co-authored-by: Patricia Santa Ana <[email protected]>
- Loading branch information
1 parent
18050a7
commit 4ef2a87
Showing
18 changed files
with
80 additions
and
20 deletions.
There are no files selected for viewing
60 changes: 60 additions & 0 deletions
60
content/cloudflare-one/applications/configure-apps/saas-apps/braintree-saas.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,60 @@ | ||
--- | ||
pcx_content_type: how-to | ||
title: Braintree | ||
weight: 5 | ||
--- | ||
|
||
# Connect to Braintree through Access | ||
|
||
This guide covers how to configure [Braintree](https://developer.paypal.com/braintree/articles/guides/single-sign-on-sso) as a SAML application in Cloudflare Zero Trust. | ||
|
||
## Prerequisites | ||
|
||
- A [SAML identity provider](/cloudflare-one/identity/idp-integration/generic-saml/) configured in Cloudflare Zero Trust | ||
- Admin access to a Braintree production or sandbox account | ||
|
||
## 1. Add a SaaS application to Cloudflare Zero Trust | ||
|
||
1. In [Zero Trust](https://one.dash.cloudflare.com), go to **Access** > **Applications**. | ||
2. Select **Add an application** > **SaaS** > **Select**. | ||
3. For **Application**, enter `Braintree` and select the textbox that appears below. | ||
4. For the authentication protocol, select **SAML**. | ||
5. Select **Add application**. | ||
6. Fill in the following fields with temporary values: | ||
- **Entity ID**: `placeholder` | ||
- **Assertion Consumer Service URL**: `https://www.placeholder.com` | ||
- **Name ID format**: _Email_ | ||
7. Copy the **SSO endpoint** and **Public key**. | ||
8. Select **Save configuration**. | ||
9. Configure [Access policies](/cloudflare-one/policies/access/) for the application. | ||
10. Select **Done**. | ||
|
||
## 2. Enable SSO Configuration in Braintree | ||
|
||
1. In Braintree, create a [support ticket](https://developer.paypal.com/braintree/help). | ||
2. In **Search Issues**, enter `Login and password issues` and select the corresponding value. | ||
3. In **Issue Details**, fill in the following: | ||
- **Merchant ID**: Your Braintree Merchant ID. This is the 16-digit value that follows `/merchants/`in your Braintree Control Panel URL. | ||
- **Email domain(s) to be used in user IDs**: The email domain(s) that should be allowed to sign in to your account via SSO. | ||
- **Single Sign-on HTTP POST Binding URL**: SSO endpoint from application configuration in Cloudflare Zero Trust | ||
- **Certificate for validation**: Public key from application configuration in Cloudflare Zero Trust. | ||
4. Select whether you are using a **Production** or **Sandbox** account. | ||
5. Fill out the **Your contact information** fields and select **Submit a help request**. | ||
6. When you receive an email stating SSO has been successfully configured for your account, you can proceed to the next step. | ||
|
||
## 3. Finish adding a SaaS application to Cloudflare Zero Trust | ||
|
||
1. In [Zero Trust](https://one.dash.cloudflare.com), go to **Access** > **Applications**. | ||
2. Select **Braintree** > **Edit** > **Overview**. | ||
3. Replace the temporary values for **Entity ID** and **Assertion Consumer Service URL** with the link provided in the successful SSO configuration email from Braintree support. You will use the same link for both values. | ||
4. Select **Save Application**. | ||
|
||
## 4. Test the integration and add SSO users | ||
|
||
1. In your Braintree Control Panel, select the **settings** icon > **Team**. | ||
2. Select your desired test user. | ||
3. Under **Single Sign-On**, select **Enable**. | ||
4. Open an incognito browser window. In the address bar, paste `https://id.sandbox.braintreegateway.com` for a sandbox account or | ||
`https://id.braintreegateway.com` for a production account. | ||
5. In **Your corporate email address** field, type your test user's email. You will be redirected to the Cloudflare Access login screen and prompted to sign in with your identity provider. | ||
6. Upon successful sign-in, you can enable SSO for other users using steps 4.1 - 4.3. |
4 changes: 2 additions & 2 deletions
4
content/cloudflare-one/applications/configure-apps/saas-apps/digicert-saas.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
content/cloudflare-one/applications/configure-apps/saas-apps/docusign-access.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,7 +1,7 @@ | ||
--- | ||
pcx_content_type: how-to | ||
title: DocuSign | ||
weight: 6 | ||
weight: 7 | ||
--- | ||
|
||
# Connect to DocuSign through Access | ||
|
2 changes: 1 addition & 1 deletion
2
content/cloudflare-one/applications/configure-apps/saas-apps/google-cloud-saas.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
...t/cloudflare-one/applications/configure-apps/saas-apps/google-workspace-saas.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
content/cloudflare-one/applications/configure-apps/saas-apps/greenhouse-saas.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
content/cloudflare-one/applications/configure-apps/saas-apps/hubspot-saas.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,7 +1,7 @@ | ||
--- | ||
pcx_content_type: how-to | ||
title: Hubspot | ||
weight: 9 | ||
weight: 10 | ||
--- | ||
|
||
# Connect to Hubspot through Access | ||
|
2 changes: 1 addition & 1 deletion
2
content/cloudflare-one/applications/configure-apps/saas-apps/jamf-pro-saas.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,7 +1,7 @@ | ||
--- | ||
pcx_content_type: how-to | ||
title: Jamf Pro | ||
weight: 10 | ||
weight: 11 | ||
--- | ||
|
||
# Connect to Jamf Pro through Access | ||
|
6 changes: 3 additions & 3 deletions
6
...ent/cloudflare-one/applications/configure-apps/saas-apps/pagerduty-saml-saas.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
content/cloudflare-one/applications/configure-apps/saas-apps/pingboard-saas.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
...nt/cloudflare-one/applications/configure-apps/saas-apps/salesforce-saas-oidc.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
...nt/cloudflare-one/applications/configure-apps/saas-apps/salesforce-saas-saml.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
...nt/cloudflare-one/applications/configure-apps/saas-apps/servicenow-saas-oidc.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
...nt/cloudflare-one/applications/configure-apps/saas-apps/servicenow-saas-saml.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
content/cloudflare-one/applications/configure-apps/saas-apps/slack-saas.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,7 +1,7 @@ | ||
--- | ||
pcx_content_type: how-to | ||
title: Slack | ||
weight: 15 | ||
weight: 16 | ||
--- | ||
|
||
# Connect to Slack through Access | ||
|
2 changes: 1 addition & 1 deletion
2
content/cloudflare-one/applications/configure-apps/saas-apps/smartsheet-saas.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,7 +1,7 @@ | ||
--- | ||
pcx_content_type: how-to | ||
title: Smartsheet | ||
weight: 16 | ||
weight: 17 | ||
--- | ||
|
||
# Connect to Smartsheet through Access | ||
|
2 changes: 1 addition & 1 deletion
2
content/cloudflare-one/applications/configure-apps/saas-apps/tableau-saml-saas.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
content/cloudflare-one/applications/configure-apps/saas-apps/zendesk-sso-saas.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,7 +1,7 @@ | ||
--- | ||
pcx_content_type: how-to | ||
title: Zendesk | ||
weight: 18 | ||
weight: 19 | ||
--- | ||
|
||
# Connect to Zendesk through Access | ||
|