Authentication

The following guide describes how to obtain a token for usage with Monogoto API functionality.

Authenticate your user account to obtain a login token

POST https://console.monogoto.io/Auth

Request Body

Name	Type	Description
UserName*	String	Your username
Password*	String	Your password

200: OK OK

{
    "token": "eyJhb6IkpXVCJ9.eyJSb2xlIjoiVXN4lclByb2ZpbGVJZF9kZGM2MThhNC0wNTI1LTQ2MmUtYWN3NzhhMGQxYmbSI6Im4zgFkbWluIiwiQ3VzdG9tsbCwiVXNlcklkIjoiVklkXzg5Yj5Y2OGEyUtNDQThhLTEzZjA0MzJhZDE3YyINTAzgZmUtZGI51My00ZjRiLTktN2U5Yjc0ZWU1ZThlIiwiaWNzM3MjI5L2MDY3NTE2Mjl9.99aSLzP7kTgK6TZGW-xalrMu0GkW6viunt3XxbNng",
    "refreshToken": "eyJhb6IkpXVCJ9.eyJSb2xlIjoiVXN4lclByb2ZpbGVJZF9kZGM2MThhNC0wNTI1LTQ2MmUtYWN3NzhhMGQxYmbSI6Im4zgFkbWluIiwiQ3VzdG9tsbCwiVXN6lcklkjoiVklkXzg5Y2464OGEyUtND8ThhLTEzZjA0MzJhZDE3YyINTAgsretszgZmUtZGI51My00ZjRiLTktN2U5Yjc0ZWU1ZThlIiwiaWNzM3MjI5L2MD5786bzdhfdzhY3NTE2Mjl9.99aSLzP7kTgK6TZGW-xalrMu0GkW6viunt3XxbNng8vz567dfzgzfgEtT789D43dWEEW",
    "CustomerId": "cid_ecs1d3a5-f5e62a1-fe8af468wf",
    "UserId": "UserId_a76ty5a5-489a-4b87-9b9u-455f451d99fb",
    "UserName": "[e-mail]",
    "Role": "UserProfileId_40e0998a-ef5c-4bbd-a18bc-2864y6100d1",
    "Realm": "customer",
    "OrganizationId": "OrganizationId_235348d7d-dd99-4111-ab2b-1ec612d9b11a",
    "AccountSettings": {
        "TwoFactorAuthentication": false
    },
    "ThingsGroupIds": [],
    "UserProfile": {
        "Permissions": {
            "API": ["view"],
            "AlertsTasksSettings": ["view", "edit", "delete"],
            "ApnAllowedToCustomer": ["view", "edit", "delete"],
            "AuditLogs": ["view"],
            "AuditLogsOwned": ["view"],
            "BillingReports": ["view"],
            "CurrencyCodes": ["view"],
            "Dashboard": ["view", "edit", "delete"],
            "ExternalHLR": ["view"],
            "GlobalSettings": ["view"],
            "IpPools": ["view", "edit", "delete"],
            "MobileSubscriber": ["view", "edit", "delete"],
            "NetwSecSettings": ["view", "edit", "delete"],
            "NetworkProvider": ["view"],
            "NetworkProviderDetails": ["view", "edit", "delete"],
            "PortalAlertsTasksSettings": ["view"],
            "PortalAuditLogs": ["view"],
            "PortalBillingReports": ["view"],
            "PortalDashboard": ["view"],
            "PortalIpPools": ["view"],
            "PortalLogin": ["view"],
            "PortalMobileIdentities": ["view"],
            "PortalNetwork": ["view"],
            "PortalPricePlanDetails": ["view"],
            "PortalRealtimeDashboard": ["view"],
            "PortalRoamingOwned": ["view"],
            "PortalSecurity": ["view"],
            "PortalSettings": ["view"],
            "PortalThings": ["view"],
            "PortalThingsGroups": ["view"],
            "PortalUsers": ["view"],
            "PricePlanDetails": ["view", "edit", "delete"],
            "RoamingOwned": ["view", "edit", "delete"],
            "Settings": ["view"],
            "Tags": ["view", "edit", "delete"],
            "TagsOwned": ["view", "edit", "delete"],
            "Things": ["view", "edit", "delete"],
            "ThingsGroup": ["view", "edit", "delete"],
            "ThingsGroupOwned": ["view", "edit", "delete"],
            "ThingsSensitiveData": ["view", "edit", "delete"],
            "UserProfile": ["view"],
            "Users": ["view", "edit", "delete"],
            "PortalReports": ["view"],
            "ReportTemplate": ["view", "edit", "delete"],
            "ReportHistory": ["view", "edit", "delete"],
            "DownloadReportInPdf": ["view", "edit", "delete"],
            "Scheduler": ["view", "edit", "delete"],
            "PortalScheduler": ["view"],
            "Search": ["view7", "edit", "delete"],
            "DownloadPCAPFile": ["view"],
            "DataLocationService": ["view"],
            "Bundle": ["view", "edit", "delete"]
        },
        "DateCreated": 1550396272390,
        "Name": "Customer Admin",
        "Realm": "customer",
        "Type": "USER_PROFILE",
        "UserProfileId": "UserProfileId_40e0998a-ef5c-4bbd-a18bc-2864y6100d1",
        "DateModified": 1606904198590,
        "cas": "160777788521644"
    }
}

404: Not Found Access denied

{
    Access denied
}

Add your UserName and Password in the POST request to successfully obtain your login token.

{
  "UserName": "string",
  "Password": "string"
}

Example using cURL:

curl -X POST \
     --url 'https://console.monogoto.io/Auth' \
     -H 'Content-Type: application/json' \
     -d '{
        "UserName": "string",
        "Password": "string"
        }'

Example response showing the login token, CustomerID etc:

{
    "token": "eyJhb6IkpXVCJ9.eyJSb2xlIjoiVXN4lclByb2ZpbGVJZF9kZGM2MThhNC0wNTI1LTQ2MmUtYWN3NzhhMGQxYmbSI6Im4zgFkbWluIiwiQ3VzdG9tsbCwiVXNlcklkIjoiVklkXzg5Yj5Y2OGEyUtNDQThhLTEzZjA0MzJhZDE3YyINTAzgZmUtZGI51My00ZjRiLTktN2U5Yjc0ZWU1ZThlIiwiaWNzM3MjI5L2MDY3NTE2Mjl9.99aSLzP7kTgK6TZGW-xalrMu0GkW6viunt3XxbNng",
    "refreshToken": "eyJhb6IkpXVCJ9.eyJSb2xlIjoiVXN4lclByb2ZpbGVJZF9kZGM2MThhNC0wNTI1LTQ2MmUtYWN3NzhhMGQxYmbSI6Im4zgFkbWluIiwiQ3VzdG9tsbCwiVXN6lcklkjoiVklkXzg5Y2464OGEyUtND8ThhLTEzZjA0MzJhZDE3YyINTAgsretszgZmUtZGI51My00ZjRiLTktN2U5Yjc0ZWU1ZThlIiwiaWNzM3MjI5L2MD5786bzdhfdzhY3NTE2Mjl9.99aSLzP7kTgK6TZGW-xalrMu0GkW6viunt3XxbNng8vz567dfzgzfgEtT789D43dWEEW",
    "CustomerId": "cid_ecs1d3a5-f5e62a1-fe8af468wf",
    "UserId": "UserId_a76ty5a5-489a-4b87-9b9u-455f451d99fb",
    "UserName": "[e-mail]",
    "Role": "UserProfileId_40e0998a-ef5c-4bbd-a18bc-2864y6100d1",
    "Realm": "customer",
    "OrganizationId": "OrganizationId_235348d7d-dd99-4111-ab2b-1ec612d9b11a",
    "AccountSettings": {
        "TwoFactorAuthentication": false
    },
    "ThingsGroupIds": [],
    "UserProfile": {
        "Permissions": {
            "API": ["view"],
            "AlertsTasksSettings": ["view", "edit", "delete"],
            "ApnAllowedToCustomer": ["view", "edit", "delete"],
            "AuditLogs": ["view"],
            "AuditLogsOwned": ["view"],
            "BillingReports": ["view"],
            "CurrencyCodes": ["view"],
            "Dashboard": ["view", "edit", "delete"],
            "ExternalHLR": ["view"],
            "GlobalSettings": ["view"],
            "IpPools": ["view", "edit", "delete"],
            "MobileSubscriber": ["view", "edit", "delete"],
            "NetwSecSettings": ["view", "edit", "delete"],
            "NetworkProvider": ["view"],
            "NetworkProviderDetails": ["view", "edit", "delete"],
            "PortalAlertsTasksSettings": ["view"],
            "PortalAuditLogs": ["view"],
            "PortalBillingReports": ["view"],
            "PortalDashboard": ["view"],
            "PortalIpPools": ["view"],
            "PortalLogin": ["view"],
            "PortalMobileIdentities": ["view"],
            "PortalNetwork": ["view"],
            "PortalPricePlanDetails": ["view"],
            "PortalRealtimeDashboard": ["view"],
            "PortalRoamingOwned": ["view"],
            "PortalSecurity": ["view"],
            "PortalSettings": ["view"],
            "PortalThings": ["view"],
            "PortalThingsGroups": ["view"],
            "PortalUsers": ["view"],
            "PricePlanDetails": ["view", "edit", "delete"],
            "RoamingOwned": ["view", "edit", "delete"],
            "Settings": ["view"],
            "Tags": ["view", "edit", "delete"],
            "TagsOwned": ["view", "edit", "delete"],
            "Things": ["view", "edit", "delete"],
            "ThingsGroup": ["view", "edit", "delete"],
            "ThingsGroupOwned": ["view", "edit", "delete"],
            "ThingsSensitiveData": ["view", "edit", "delete"],
            "UserProfile": ["view"],
            "Users": ["view", "edit", "delete"],
            "PortalReports": ["view"],
            "ReportTemplate": ["view", "edit", "delete"],
            "ReportHistory": ["view", "edit", "delete"],
            "DownloadReportInPdf": ["view", "edit", "delete"],
            "Scheduler": ["view", "edit", "delete"],
            "PortalScheduler": ["view"],
            "Search": ["view7", "edit", "delete"],
            "DownloadPCAPFile": ["view"],
            "DataLocationService": ["view"],
            "Bundle": ["view", "edit", "delete"]
        },
        "DateCreated": 1550396272390,
        "Name": "Customer Admin",
        "Realm": "customer",
        "Type": "USER_PROFILE",
        "UserProfileId": "UserProfileId_40e0998a-ef5c-4bbd-a18bc-2864y6100d1",
        "DateModified": 1606904198590,
        "cas": "160777788521644"
    }
}

Authorization Header

Once you obtained a token, make sure to add your login token to the the authorization header in all requests.

-H 'authorization: Bearer {YOUR_TOKEN}'

Example

curl --request GET \
     --url https://console.monogoto.io/thing/{YOUR_THING_ID}/state \
     -H 'Accept: application/json' \
     -H 'Authorization: Bearer {YOUR_TOKEN}'

Error with : Failed to convert Swagger 2.0 to OpenAPI 3.1.1