Skip to main content

Google

As a Kisi organization owner you can set up Google single sign-on (SSO) for your Kisi users.

Enable SSO on Google

Set up the integration in Google

  1. Sign in to your Google Workspace Admin Console
  2. Click on Apps
  3. Choose SAML apps
  4. Click on the Add App dropdown menu and select Add custom SAML app
  5. Define an app name (e.g. Kisi SSO) and click Continue
  6. Download IDP metadata and click Continue
  7. Fill out the fields as follows:
  • ACS URL: https://api.kisi.io/saml/consume/<your-kisi-domain>. (You can find your Kisi organization domain under Organization Setup > Settings)
  • Entity ID: https://api.kisi.io/saml/metadata
  • Start URL: Leave empty
  • Signed Response: Check
  • Name ID Format: Persistent
  • Name ID: Basic Information - Primary Email
  1. Click Continue
  2. In the Attribute Mapping section, click Add Mapping and fill out the fields as follows:
  • Basic information: Primary email
  • App attributes: Email
  1. Click Finish
  2. In the User access section, click on the arrow to edit the Service Status
  3. Select ON for everyone and click Save
  4. Assign users to the Kisi Application

Set up the integration in Kisi

  1. Sign in to Kisi
  2. Under Organization Setup, click on SSO & SCIM and paste the Metadata file that you downloaded in the steps above
  3. Click Save
  4. Click Generate Certificate

Import users from Google Directory

Customers who don't yet have SSO set up can still import users from their Google Directory by manually setting up the integration. We recommend, however, setting up SSO to allow your Kisi users to log in with their single, existing credentials.

To be able to set this integration up, you need to have Google Directory setup with at least one Organization unit.

info

User import integrations can only be done on organization level. This means, you can only import users into organization groups, but not into place groups. Learn more about group types here.

  1. Sign in to Kisi
  2. Under Organization Setup, select Integrations and click Add Integration
  3. Enter a name, open the Type dropdown and select Google Directory User Import
  4. Click Authorize with Google and you’ll be redirected to the Google Authentication screen
  5. Sign in with your Google account that has Admin privileges
  6. Click Accept to allow the integration read access
  7. Once back in Kisi, select the organizational unit you want to use from Google. The organizational unit needs to be a sub-organization. If you have not created one, you will need to do so
  8. Define if the import should be done into a Kisi group or as users only
  • For the group option, map users to the Kisi Group. A Kisi Group is needed to share access to your place(s) with your users.
  • For the users only option, users will be imported but won't receive an invitation email from Kisi or have any access in your place(s)
  1. Click Add

The integration will be set up immediately. Everyone in the Google Organizational Unit will get an email notification that Kisi access has been shared with them, unless you chose to import as users only.