Integrations

We are offering several ways for integrating your existing customer backend, into your Smart Space. The following alphabetical ordered list gives you an overview of the current supported authentication providers.

They are all offering the possibility to use them as an authentication backend, for managing your customer base and can be used for authentication into our mobile applications.

You can decide if we should sync personal information of the authenticated users into your Smart Space backend. This can be helpful for a better overview, but may be in conflict with data privacy laws. Your Smart Space backend can work also without those information.

Please keep in mind, that the user data will only be synced, if the user signs in the first time. Your Smart Space backend will re-validate the information each night. If this fails, the user will be blocked. If you need to remove a user immediatly, please disable the user at your identity provider and delete the account in the Smart Space backend.

After you created the mobile application with the specific information for your integration, just select the application in your OAuth application.

If you are missing an integration, feel free to contact us. We’re relying on OAuth2 as our authorization protocol. If your solution also supports OAuth2 an integration can be create very easily.

BambooHR

BambooHR is a human resource software for small and medium businesses. You can use BambooHR together with the Smart Space mobile applications.

For integration, please contact BambooHR to get the client_id and client_secret. You need to provide them the correct redirect URI, which would be: https://$your-name.sensorberg.com/auth/bamboohr/callback.

After you obtained those information, please create a new mobile app with the following information:

  • Authentication type: External OAuth2 Provider
  • OAuth Provider: BambooHR
  • Client ID: $your-client-id
  • Client Secret: $your-client-secret
  • Site URL: https://$yourname.bamboohr.co.uk/

Cobot

Cobot is offering a coworking management software. You can use Cobot to manage you coworking space.

To integrate Cobot into your Smart Space backend, please create the required client_id and client_secret - use https://$your-name.sensorberg.com/auth/cobot/callback as the redirect URI and read_user as scope. “Name” could be “SmartSpace Authentication” and the “Main Application URL” can point to your main website.

After you created those information, you need to add a new mobile app with the following information:

  • Authentication type: External OAuth2 Provider
  • OAuth Provider: Cobot
  • Client ID: $your-client-id
  • Client Secret: $your-client-secret

Google Identity

Google Identity Service is one of the largest identity providers. You can integrate it as your authentication provider for your Smart Space solution. For creating the client_id and client_secret, please follow the following steps:

  1. Go to Google Developer Console
  2. Select or create your project
  3. Click ‘Enable and manage APIs’
  4. Make sure “Contacts API” and “Google+ API” are active
  5. Go to Credentials, then select the “OAuth consent screen” tab on top, and provide an ‘email address’ and a ‘product name’
  6. Wait for 10 minutes for changes to take effect

After you created those information, you need to add a new mobile app with the following information:

  • Authentication type: External OAuth2 Provider
  • OAuth Provider: Google Identity Service
  • Client ID: $your-client-id
  • Client Secret: $your-client-secret

Keycloak

Keycloak is an Open Source identity and access management solution. You can use Keycloak for integration into your Smart Space solution.

We are offering a “Generic OAuth Provider” which can be used for integration.

  • Authentication type: External OAuth2 Provider
  • OAuth Provider: Generic
  • Client ID: $your-client-id
  • Client Secret: $your-client-secret
  • Site URL: Base URL of your Keycloak installation
  • Authorize URL: f.e. /auth/realms/master/protocol/openid-connect/auth
  • Token URL: f.e. /auth/realms/master/protocol/openid-connect/token
  • Path of raw information: f.e. /auth/realms/master/protocol/openid-connect/userinfo
  • Path to UID in raw information: sub