Integration Security and Troubleshooting
Section titled “Integration Security and Troubleshooting”Protect organization credentials
Section titled “Protect organization credentials”OAuth credentials and refresh tokens should be handled server-side. Do not paste tokens, API secrets, or integration credentials into support tickets, documentation, or client-side code.
Review permission scope
Section titled “Review permission scope”When connecting an external service:
- Use the organization account intended for the integration.
- Review the permissions requested by the provider.
- Limit administrative access to staff who need to manage integrations.
- Revoke or reconnect access when ownership changes.
Google connection shows disconnected
Section titled “Google connection shows disconnected”Try these steps:
- Refresh the Integrations page.
- Confirm the Google account still has permission to the required services.
- Reconnect if the authorization was revoked or expired.
- Ask an OKTO administrator to review the organization integration configuration if the connection still fails.
A Google feature is missing
Section titled “A Google feature is missing”Confirm both the organization connection and the individual service are enabled. Some features also appear only in specific modules or for users with the required OKTO permissions.
Maps or address features are unavailable
Section titled “Maps or address features are unavailable”Location functionality can depend on organization configuration and provider keys maintained by the platform. If the organization connection is healthy but location features are still unavailable, contact OKTO support with the affected screen and organization—not with secret keys.