...
Field | Required for OpenID SSO | Required for SAML SSO | Change with the tenant and the environment | Defaults fields | Description |
---|---|---|---|---|---|
environment | - | - | Yes (with the env. only) | - | The environment of the platform your are integrated to; accepted values: |
app.host | Yes | Yes | Yes (with the env. only) | - | Your application host |
api.id | Yes | Yes | Yes | - | The id of your app |
api.host | Yes | Yes | Yes | - | The platform host |
sso.idm | - | - | - | same as config.app.host | Your Identity Domain Manager |
sso.init_path | - | Yes | your choice | - | Your application path that allows users to initiate |
sso.consume_path | - | Yes | your choice | - | Your application path to the SAML endpoint that allows |
sso.idp | Yes | Yes | Yes | if "environment" is set: | The platform host |
sso.x509_fingerprint | - | Yes | Yes | only if "environment" is set: | |
sso.x509_certificate | - | Yes | Yes | if "environment" is set: | |
connec.host | Yes | Yes | Yes | if "environment" is set: | The Connec! endpoint used to fetch data from |
webhook.account.group_path | Yes | Yes | your choice | - | Your application path where a notification will be posted |
webhook.account.group_users_path | Yes | Yes | your choice | - | Your application path where a notification will be posted |
webhook.connec.notifications_path | Yes | Yes | your choice | - | Your application path where notifications |
wenhook.connec.subscriptions | Yes | Yes | No | false for all entities | The list of entities (organizations, people, invoices etc.) |
4 How
...
can I test my integration?
The sandbox One of the sandboxes application should be used during the integration phase, or for any non-production environment. You can add the application to your dashboard easily by clicking on the Start Sandbox App button and then choosing the appropriate company.
Once added to your dashboard, you can initiate the SSO process by starting the application, clicking on the application tiletitle.
To test the data sharing end-to-end between your application and another application from the Maestrano platform, you will have to launch an other application on your dashboard. When records are created/updated in a system, notifications will be sent to the other applications from your Maestrano eco-system.