You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/production-deployment/cloud/saml.mdx
+38-27Lines changed: 38 additions & 27 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,9 @@
2
2
id: saml
3
3
title: SAML authentication
4
4
sidebar_label: SAML authentication
5
-
description: Integrate SAML 2.0 with your Temporal Cloud account for secure user authentication. Connect via Microsoft Entra ID or Okta and ensure seamless SSO. Charges apply.
5
+
description:
6
+
Integrate SAML 2.0 with your Temporal Cloud account for secure user authentication. Connect via Microsoft Entra ID or
7
+
Okta and ensure seamless SSO. Charges apply.
6
8
slug: /cloud/saml
7
9
toc_max_heading_level: 4
8
10
keywords:
@@ -16,7 +18,8 @@ tags:
16
18
- Users
17
19
---
18
20
19
-
To authenticate the users of your Temporal Cloud account, you can connect an identity provider (IdP) to your account by using Security Assertion Markup Language (SAML) 2.0.
21
+
To authenticate the users of your Temporal Cloud account, you can connect an identity provider (IdP) to your account by
22
+
using Security Assertion Markup Language (SAML) 2.0.
20
23
21
24
:::info
22
25
@@ -26,28 +29,29 @@ SAML is a paid feature. See the [pricing page](/cloud/pricing) for details.
26
29
27
30
## Integrate SAML with your Temporal Cloud account
28
31
29
-
1. Locate your [Temporal Cloud Account Id](/cloud/namespaces#temporal-cloud-account-id).
30
-
Your Account Id can be viewed and copied from the Temporal Cloud user profile dropdown menu in the top right corner.
31
-
Alternatively, find your [Namespace Id](/cloud/namespaces#temporal-cloud-namespace-id).
32
-
The Account Id is the five or six characters following the period (.), such as `f45a2`.
33
-
You will need the Account Id to construct your callback URL and your entity identifier.
32
+
1. Locate your [Temporal Cloud Account Id](/cloud/namespaces#temporal-cloud-account-id). Your Account Id can be viewed
33
+
and copied from the Temporal Cloud user profile dropdown menu in the top right corner. Alternatively, find your
34
+
[Namespace Id](/cloud/namespaces#temporal-cloud-namespace-id). The Account Id is the five or six characters following
35
+
the period (.), such as `f45a2`. You will need the Account Id to construct your callback URL and your entity
36
+
identifier.
34
37
1. Configure SAML with your IdP by following one of these sets of instructions:
1.[Share your connection information with us and test your connection.](#finish-saml-configuration)
38
41
39
42
## How to configure SAML with Microsoft Entra ID {#configure-saml-with-azure-ad}
40
43
41
-
If you want to use the general Microsoft login mechanism, you don't need to set up SAML with Entra ID.
42
-
Just select **Continue with Microsoft** on the Temporal Cloud sign-in page.
44
+
If you want to use the general Microsoft login mechanism, you don't need to set up SAML with Entra ID. Just select
45
+
**Continue with Microsoft** on the Temporal Cloud sign-in page.
43
46
44
47
To use Entra ID as your SAML IdP, create a Microsoft Entra ID Enterprise application.
45
48
46
49
1. Sign in to the [Microsoft Entra ID](https://portal.azure.com/).
47
50
1. On the home page, under **Manage Microsoft Entra ID**, select **View**.
48
51
1. On the **Overview** page near the top, select **Add > Enterprise application**.
49
52
1. On the **Browse Microsoft Entra ID Gallery** page near the top, select **Create your own application**.
50
-
1. In the **Create your own application** pane, provide a name for your application (such as `temporal-cloud`) and select **Integrate any other application you don't find in the gallery**.
53
+
1. In the **Create your own application** pane, provide a name for your application (such as `temporal-cloud`) and
54
+
select **Integrate any other application you don't find in the gallery**.
51
55
1. Select **Save**.
52
56
1. In the **Getting Started** section, select **2. Set up single sign on**.
53
57
1. On the **Single sign-on** page, select **SAML**.
@@ -64,7 +68,8 @@ To use Entra ID as your SAML IdP, create a Microsoft Entra ID Enterprise applica
64
68
urn:auth0:prod-tmprl:f45a2-saml
65
69
```
66
70
67
-
1. In **Reply URL (Assertion Consumer Service URL)**, enter the following callback URL, including your Account Id where indicated:
71
+
1. In **Reply URL (Assertion Consumer Service URL)**, enter the following callback URL, including your Account Id where
1. In the **Attributes & Claims** section, select **Edit**.
94
-
1. We require the user's full email address when connecting to Temporal.
95
-
In the **Required claim** section, set **email** and **name**.
96
-
Verify that **Unique User Identifier (NameID)** is set to `user.userprincipalname [nameid-format:emailAddress]`.
96
+
1. You can leave the other fields blank. Near the top of the pane, select **Save**.
97
+
1. In the **Attributes & Claims** section, select **Edit**. Configure the following settings. Under **Required claim**:
98
+
99
+
- Set **Unique User Identifier (NameID)** to `user.userprincipalname`
100
+
- Set the **NameID format** to `emailAddress`
101
+
102
+
These are the default settings for Microsoft Entra ID. Then under **Additional claims**, ensure **Email** and
103
+
**Name** are present.
104
+
97
105
1. Collect information that you need to send to us:
98
-
- In the **SAML Certificates** section of the **SAML-based Sign-on** page, select the download link for **Certificate (Base64)**.
106
+
- In the **SAML Certificates** section of the **SAML-based Sign-on** page, select the download link for **Certificate
107
+
(Base64)**.
99
108
- In the **Set up _APPLICATION_NAME_** section of the **SAML-based Sign-on** page, copy the value of **Login URL**.
100
109
101
110
To finish setting up Microsoft Entra ID as your SAML IdP, see [Finish SAML configuration](#finish-saml-configuration).
@@ -108,8 +117,10 @@ To use Okta as your SAML IdP, configure a new Okta application integration.
108
117
1. In the left navigation pane, select **Applications > Applications**.
109
118
1. On the **Applications** page, select **Create App Integration**.
110
119
1. In the **Create a new app integration** dialog, select **SAML 2.0** and then select **Next**.
111
-
1. On the **Create SAML Integration** page in the **General Settings** section, provide a name for your application (such as `temporal-cloud`) and then select **Next**.
112
-
1. In the **Configure SAML** section in **Single sign on URL**, enter the following callback URL, including your Account Id where indicated:
120
+
1. On the **Create SAML Integration** page in the **General Settings** section, provide a name for your application
121
+
(such as `temporal-cloud`) and then select **Next**.
122
+
1. In the **Configure SAML** section in **Single sign on URL**, enter the following callback URL, including your Account
0 commit comments