Skip to content
Pre-Release

This feature is actively being developed. Breaking changes should be expected. Synqly Labs is available only in Synqly Mesh.

Please contact us before using this feature.

Google

Labs URL: synqly://labs/google

Create a Labs integration

  1. Create an integration for the provider, the same way you would for the real provider.
  2. Set the provider's URL to the Labs URL at the top of this page.
  3. Fill in the credential fields. Labs accepts any value, but the credential must be the type the provider asks for, such as an OAuth client ID and secret or an API token.

Then call any operation the provider supports. Your requests run through the same connector that serves a real provider tenant, so the responses have the provider's shape and your code works against the real provider without changes.

The client secret must be a private key in PEM format, because the connector signs its requests with it. Labs does not check the signature, so any RSA or P-256 key works. You can create one with OpenSSL:

openssl genpkey -algorithm EC -pkeyopt ec_paramgen_curve:P-256

The client email and the delegate can be any email address.

Test how your code handles errors

These credential values make Labs fail the way the provider does when a credential is wrong, lacks permission, or hits a rate limit. Any other value succeeds.

ResponseClient email
Authentication failslabs-invalid-auth@acme-labs.iam.gserviceaccount.com
403 Forbidden on every requestlabs-forbidden@acme-labs.iam.gserviceaccount.com
429 Too Many Requests on every requestlabs-rate-limited@acme-labs.iam.gserviceaccount.com

Identity

Provider: Google Workspace

OperationOn Labs
disable_userAvailable
enable_userAvailable
expire_all_user_sessionsAvailable
force_user_password_resetAvailable
get_groupAvailable
get_group_membersAvailable
get_userAvailable
get_user_pictureAvailable
query_audit_logAvailable
query_groupsAvailable
query_usersAvailable

query_audit_log

FilterOperatorsNot on Labs
activity_nameeq, ne, in, not_in, like, not_like
class_uideq, ne, in, not_in, gt, gte, lt, lte
src_endpoint.ipeq
timegte, lte
type_uideq, ne, in, not_in, gt, gte, lt, lte
user.email_addreq, ne, gt, gte, lt, lte
SortDirectionsNot on Labs
timedesc

query_groups

FilterOperatorsNot on Labs
entity.group.email_addreq, in
SortDirectionsNot on Labs
entity.group.email_addrasc, desc

query_users

FilterOperatorsNot on Labs
entity.uideq, in
entity.user.email_addreq, in
entity.user.full_nameeq, in
entity.user.ldap_person.cost_centereq, in
entity.user.ldap_person.employee_uideq, in
entity.user.ldap_person.given_nameeq, in
entity.user.ldap_person.job_titleeq, in
entity.user.ldap_person.surnameeq, in
entity.user.nameeq, in
entity.user.org.nameeq, in
entity.user.org.ou_nameeq, in
entity.user.uideq, in
entity.user.uid_alteq, in
SortDirectionsNot on Labs
entity.user.email_addrasc, desc