> For the complete documentation index, see [llms.txt](https://docs.simpleokr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.simpleokr.com/simple-okr-manual/settings/security/single-sign-on/g-suite-configuration.md).

# G Suite Configuration

To configure G Suite as Identity Provider for Simple OKR follow the steps on this page.

### Enable SSO on G Suite

Head to `Google Admin -> Security -> Setup single sign on SSO`. Under Setup SSO with Google Identity provider section, generate a new certificate if none are available.

![](/files/-LpxiI291OmB2B8dgIRh)

Click on `Download IDP Metadata` to download XML metadata containing information about the identity provider. We will need this file later to configure Simple OKR.

### Create a new SAML App

Head to `Google Admin -> Apps -> SAML Apps`. Click on the `+` button to add a new app. Then click on Setup Custom SAML app. Follow the configuration wizard until you reach the Service Provider configuration page:

![](/files/-Lpxln32mv_XOZmTlp57)

Under ACS URL enter: `https://app.simpleokr.com/auth/saml/acs`

Under Entity ID enter: `https://app.simpleokr.com/auth/saml/metadata`

Leave the remaining settings as shown in the screenshot above.

You can provide additional information to Simple OKR from the identity provider. This step is optional, however we advise you to fill out the attribute mapping. On the attribute mapping screen enter the configuration as shown below.

![](/files/-LpxnEyuZv9talAC3GZW)

Click Finish to create the application. Make sure the application is enabled for it to work.

Configure Simple OKR

Follow the instructions on [Custom Identity Provider page on how to configure Simple OKR](/simple-okr-manual/settings/security/single-sign-on/custom-identity-provider.md#configure-simple-okr).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.simpleokr.com/simple-okr-manual/settings/security/single-sign-on/g-suite-configuration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.