-
Notifications
You must be signed in to change notification settings - Fork 112
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
docs: add google workspace docs (#501)
* add google workspace docs * fix google-workspace.md
- Loading branch information
Showing
10 changed files
with
59 additions
and
0 deletions.
There are no files selected for viewing
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,58 @@ | ||
--- | ||
title: Google Workspcae | ||
description: Using Casdoor as SAML IdP | ||
keywords: [SAML, IdP] | ||
authors: [UsherFall] | ||
--- | ||
|
||
|
||
|
||
## Casdoor as a SAML IdP in Google Workspace | ||
|
||
This guide will show you how to configure Casdoor and Google Workspace to add Casdoor as a SAML IdP in Google Workspace | ||
|
||
### Add Certificate | ||
|
||
In Casdoor, add a certificate of type X.509 with RSA crypto algorithm and download it. | ||
|
||
![](/img/how-to-connect/saml/saml_google-workspace_cert.png) | ||
|
||
### Configure SAML Application | ||
|
||
In the application edit page, select the certificate you just created. Add the domain name of the Google application you will use in the **Redirect URLs**, such as google.com. | ||
|
||
![](/img/how-to-connect/saml/saml_google-workspace_app.png) | ||
|
||
In the **SAML reply URL** field, enter`https://www.google.com/a/<your domain>/acs`, which is the ACS URL. You can find relevant information about ACS URL here: [SSO assertion requirements](https://support.google.com/a/answer/6330801) | ||
|
||
![](/img/how-to-connect/saml/saml_google-workspace_acs.png) | ||
|
||
Copy the **sigin page URL**. This will be used in the next step. | ||
|
||
![](/img/how-to-connect/saml/saml_google-workspace_login.png) | ||
|
||
### Add Third-Party SAML IdP for Google Workspace | ||
|
||
In the Google Workspace Admin console, navigate to **Security** and then **Overview**. Look for the **SSO with third-party Idp** section. | ||
Click on Add SSO profile to access the editing page. Check the Set up SSO with third-party identity provider checkbox. Paste the copied sigin page URL into the **Sign-in page URL** and **Sign-out page URL** fields. Upload the certificate downloaded in the previous step. Click Save to save the changes. | ||
|
||
![](/img/how-to-connect/saml/saml_google-workspace_conf.png) | ||
|
||
### Add Users for Testing | ||
|
||
In Google Workspace, create a user with the username "test" (you can customize the username, this is just an example). | ||
|
||
![](/img/how-to-connect/saml/saml_google-workspace_user.png) | ||
|
||
In Casdoor, add a user with the same username as set in Google Workspace. Make sure to select the appropriate organization and enter the user's email address. | ||
|
||
![](/img/how-to-connect/saml/saml_google-workspace_test.png) | ||
|
||
As an example using "google.com," follow these steps: | ||
1. Click on the login button on the Google.com page. | ||
Enter the user's email address to initiate the login process. | ||
2. You will be redirected to the Casdoor page. | ||
On the Casdoor page, enter the corresponding email address and password. | ||
3. If the login is successful, you will be redirected back to google.com | ||
|
||
![](/img/how-to-connect/saml/saml_google-workspace_test_gif.gif) |
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
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.