Google Workspace

The Google Workspace integration connects Akiles with your organization’s Google Workspace directory. When connected, Akiles automatically creates members for users in your organization and assigns access based on Google Groups membership.

This is ideal for offices where employees already have Google Workspace accounts. Instead of manually managing Akiles members, access is derived from your existing directory.

Connecting Google Workspace

In the Akiles admin panel, go to Integrations and create a new Google Workspace integration.
Click the Connect button. You will be redirected to Google’s OAuth consent screen.
Sign in with a Google Workspace admin account and authorize Akiles to read your organization’s users and groups.

Once connected, you will see the admin email and domain of the Google Workspace organization.

Note

The Google account used to authorize the integration must be a Workspace admin. Regular user accounts do not have permission to read the organization’s directory.

Resource mapping

After connecting, Akiles imports the following as resources:

All users — A special resource that represents every active user in your Workspace. Use this to grant all employees access to a common set of doors.
Google Groups — Each Google Group in your organization appears as a separate resource.

For each resource, you can assign an Akiles member group. This determines which doors users in that group will be able to access.

A user can belong to multiple Google Groups, and each group can be mapped to a different Akiles member group. This allows flexible access control — for example, the “Engineering” group gets access to the server room, while “All users” gets access to the main entrance.

Users with no matching resource mappings will not be synced.

How members are synced

Each active user in your Google Workspace directory becomes a member in Akiles. The member’s name and email come from the directory.

Users who are suspended or archived in Google Workspace are skipped and will not have access in Akiles. If a previously active user is suspended, their Akiles member is removed.

When a user is added to or removed from a Google Group, their Akiles access is updated accordingly.

Settings

When enabled, Akiles generates a random PIN for each synced member. The PIN is not written back to Google Workspace. Users can view it if they log in to the Akiles app with their email.