# Google Workspace

{% hint style="danger" %}
Google Workspace doesn't allow callbacks to urls containing `http` or `localhost` so it can be tricky to test it locally. You should deploy CISO Assistant with a FQDN to bypass these restrictions.
{% endhint %}

Go into **Google Workspace Admin console**

1. On the sidebar menu, go to **Applications** > **Web and mobile applications**

   <figure><img src="https://intuitem.gitbook.io/ciso-assistant/~gitbook/image?url=https%3A%2F%2F217025809-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FUJGpmCYDFJNsz2CDasSm%252Fuploads%252FEtJA1LECHmogRoiwmMZv%252Fimage.png%3Falt%3Dmedia%26token%3Ddc8739bd-5356-421f-90e4-abafb9509d1f&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=e96d052c&#x26;sv=2" alt=""><figcaption></figcaption></figure>
2. Click on **Add an application** > **Add a custom SAML Application**

   <figure><img src="https://intuitem.gitbook.io/ciso-assistant/~gitbook/image?url=https%3A%2F%2F217025809-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FUJGpmCYDFJNsz2CDasSm%252Fuploads%252FD8oPs7BeTupWXPZL4UqE%252Fimage.png%3Falt%3Dmedia%26token%3D74dd38ae-4240-42cb-a8f4-175e6ef44fcc&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=a2c80f65&#x26;sv=2" alt=""><figcaption></figcaption></figure>
3. Enter **ciso-assistant** or the name of your choice and click on **continue**

   <figure><img src="https://intuitem.gitbook.io/ciso-assistant/~gitbook/image?url=https%3A%2F%2F217025809-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FUJGpmCYDFJNsz2CDasSm%252Fuploads%252FDClWvagQjZLEaRhKwaXV%252Fimage.png%3Falt%3Dmedia%26token%3D201e43aa-c56c-4803-80e5-10c5d1c49d5a&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=4d5435c2&#x26;sv=2" alt=""><figcaption></figcaption></figure>
4. You can copy the **SSO URL**, **Entity Id** and **x509 certificate** here but you'll be able to retreive them later

   <figure><img src="https://intuitem.gitbook.io/ciso-assistant/~gitbook/image?url=https%3A%2F%2F217025809-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FUJGpmCYDFJNsz2CDasSm%252Fuploads%252Fiyd2SgvFZmsawidlQFLE%252Fimage.png%3Falt%3Dmedia%26token%3D8f08d6aa-3a66-4d3a-a875-6f484f87e0db&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=dc56b401&#x26;sv=2" alt=""><figcaption></figcaption></figure>
5. Fill **ACS URL** with `<base_url>/api/accounts/saml/0/acs/`, enter the **Entity ID** which has to be the same than **SP entity Id** in CISO Assistant (**ciso-assistant** by default) and choose **Email** in **Name ID Format**

   <figure><img src="https://intuitem.gitbook.io/ciso-assistant/~gitbook/image?url=https%3A%2F%2F217025809-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FUJGpmCYDFJNsz2CDasSm%252Fuploads%252FJ9MnhNEKNxDw8bf9pzO9%252Fimage.png%3Falt%3Dmedia%26token%3Df331d567-41a9-41a5-9b54-b02cd6e062bf&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=562978c4&#x26;sv=2" alt=""><figcaption></figcaption></figure>
6. Add two mappings for **First name** and **Last Name**, fill them with those two values: `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname`

   <figure><img src="https://intuitem.gitbook.io/ciso-assistant/~gitbook/image?url=https%3A%2F%2F217025809-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FUJGpmCYDFJNsz2CDasSm%252Fuploads%252FaatBs4v7wolAL0pIiriu%252Fimage.png%3Falt%3Dmedia%26token%3D3498d78d-eb0a-4e88-a37e-f8f11a1338c8&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=b3fbced9&#x26;sv=2" alt=""><figcaption></figcaption></figure>
7. On application home page, you can now find the **Entity ID**, **SSO URL** and **x509 certificate**

   <figure><img src="https://intuitem.gitbook.io/ciso-assistant/~gitbook/image?url=https%3A%2F%2F217025809-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FUJGpmCYDFJNsz2CDasSm%252Fuploads%252FoxSYm3dIstR8FvIpn2np%252Fimage.png%3Falt%3Dmedia%26token%3D4ab6f181-5701-4da9-9ff5-b835d986beec&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=3ea2ec4d&#x26;sv=2" alt=""><figcaption></figcaption></figure>

Add a user in your application doesn't automatically create the user on CISO Assistant

You can now [configure CISO Assistant](https://docs.clario.jojmatic.com/~/revisions/XkODTcU9oZQHhpLDNQu8/features-focus/sso) with the **3 parameters** you've retrieved.<br>
