...

If no SDKs are available in the language you currently use, then it may be necessary to revert to a SDK-free integration using our REST APIs directly. This guide explains how to proceed in such case.

1 - Single Sign-

...

On 

Status
subtle true colour Red title Required

Maestrano provides two different Single Sign-On protocols: SAML 2.0 and OpenID. OpenID has become fairly more popular than SAML and is also more supported by the community. Chances are you will find a library handling OpenID out-of-the-box for your language of choice. A few examples:

...

• Membership Management: get details about your Maestrano customers (memberships) and get notified of service cancellation actions via webhooks.
  • Group/Organization
  • User
  • Groups Webhook

    Status
    colour Red title Mandatory

     
  • Group Users Webhook - Mandatory
• Billing Management: create/retrieve/cancel bills or recurring bills for your Maestrano customers.
  • Bill (Adhoc)
  • RecurringBill

...

Production endpoint: https://maestrano.com/api/v1/account/

Groups (company/organization)

...

API 

Status
subtle true colour Blue title Informational

> Retrieve your list of customers (= list of companies having selected your application on Maestrano)

...

# Request
curl -u <my-app-id>:<my-app-secret> \
  -H "Accept: application/json" \
  https://maestrano.com/api/v1/account/users/usr-2
 
# Response
{  
   "success":true,
   "errors":{},
   "data": {  
      "object":"account_user",
      "id":"usr-2",
      "name":"John",
      "surname":"Doe",
      "email":"john.doe@gmail.com",
      "country":"AU",
      "sso_session":"d7kp1b5esnfgtz6xhiv9qwlja34yu8crm2o0",
      "created_at":"2014-05-21T00:37:34Z",
      "updated_at":"2015-03-09T06:37:28Z"
   }
}

Groups Webhook - getting notified a of Group cancelling their subscription to your

...

service 

Status
subtle true colour Red title Required

When a business decides to stop using your service Maestrano will issue a DELETE request to the webhook.account.groups_path endpoint on your side (e.g.: /webhooks/maestrano/groups/:id - see the metadata section above). The call is authenticated via HTTP Basic authentication using your own API credentials (shared secret).

...

curl -u <my-app-id>:<my-app-secret> \
  -X "DELETE" \ 
  -H "Accept: application/json" \
  https://my-cloud-application.com/webhooks/maestrano/groups/cld-4

Group > Users Webhook - getting notified a of user leaving a

...

group 

Status
subtle true colour Red title Required

When a user is removed from a group, access should be disabled for that specific user. In such case Maestrano will issue a DELETE request to the webhook.account.group_users_path endpoint on your side (e.g.: /webhooks/maestrano/groups/:group_id/users/:id - see the metadata section above). The call is authenticated via HTTP Basic authentication using your own API credentials (shared secret).

...