Chilkat Online Tools

SQL Server / ForgeRock Identity Cloud Collection / Step 2e: Handle Device Profile Callback

Back to Collection Items

-- Important: See this note about string length limitations for strings returned by sp_OAMethod calls.
--
CREATE PROCEDURE ChilkatSample
AS
BEGIN
    DECLARE @hr int
    DECLARE @iTmp0 int
    -- Important: Do not use nvarchar(max).  See the warning about using nvarchar(max).
    DECLARE @sTmp0 nvarchar(4000)
    -- This example assumes the Chilkat API to have been previously unlocked.
    -- See Global Unlock Sample for sample code.

    DECLARE @http int
    -- Use "Chilkat_9_5_0.Http" for versions of Chilkat < 10.0.0
    EXEC @hr = sp_OACreate 'Chilkat.Http', @http OUT
    IF @hr <> 0
    BEGIN
        PRINT 'Failed to create ActiveX component'
        RETURN
    END

    DECLARE @success int

    -- Use this online tool to generate code from sample JSON: Generate Code to Create JSON

    -- The following JSON is sent in the request body.

    -- {
    --   "authId": "{{authId}}",
    --   "callbacks": [
    --     {
    --       "type": "DeviceProfileCallback",
    --       "output": [
    --         {
    --           "name": "metadata",
    --           "value": true
    --         },
    --         {
    --           "name": "location",
    --           "value": true
    --         },
    --         {
    --           "name": "message",
    --           "value": "Collecting....."
    --         }
    --       ],
    --       "input": [
    --         {
    --           "name": "IDToken1",
    --           "value": "{\r\n   \"identifier\":\"aec3fe784...o3Xjiizyb9=\",\r\n   \"alias\":\"Example Pixel 3 XL\",\r\n   \"metadata\":{\r\n      \"platform\":{\r\n         \"platform\":\"Android\",\r\n         \"version\":28,\r\n         \"device\":\"generic_x86_arm\",\r\n         \"deviceName\":\"AOSP on IA Emulator\",\r\n         \"model\":\"AOSP on IA Emulator\",\r\n         \"brand\":\"google\",\r\n         \"locale\":\"en_US\",\r\n         \"timeZone\":\"America\/Vancouver\",\r\n         \"jailBreakScore\":1\r\n      },\r\n      \"hardware\":{\r\n         \"hardware\":\"ranchu\",\r\n         \"manufacturer\":\"Google\",\r\n         \"storage\":774,\r\n         \"memory\":1494,\r\n         \"cpu\":4,\r\n         \"display\":{\r\n            \"width\":1440,\r\n            \"height\":2621,\r\n            \"orientation\":1\r\n         },\r\n         \"camera\":{\r\n            \"numberOfCameras\":2\r\n         }\r\n      },\r\n      \"browser\":{\r\n         \"agent\":\"Dalvik\/2.1.0 (Linux; U; Android 9; AOSP on IA Emulator Build\/PSR1.180720.117)\"\r\n      },\r\n      \"bluetooth\":{\r\n         \"supported\":false\r\n      },\r\n      \"network\":{\r\n         \"connected\":true\r\n      },\r\n      \"telephony\":{\r\n         \"networkCountryIso\":\"us\",\r\n         \"carrierName\":\"Android\"\r\n      }\r\n   },\r\n   \"location\":{\r\n      \"latitude\":{{$randomLatitude}},\r\n      \"Longitude\":{{$randomLongitude}}\r\n   }\r\n}"
    --         }
    --       ]
    --     }
    --   ]
    -- }

    DECLARE @json int
    -- Use "Chilkat_9_5_0.JsonObject" for versions of Chilkat < 10.0.0
    EXEC @hr = sp_OACreate 'Chilkat.JsonObject', @json OUT

    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'authId', '{{authId}}'
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'callbacks[0].type', 'DeviceProfileCallback'
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'callbacks[0].output[0].name', 'metadata'
    EXEC sp_OAMethod @json, 'UpdateBool', @success OUT, 'callbacks[0].output[0].value', 1
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'callbacks[0].output[1].name', 'location'
    EXEC sp_OAMethod @json, 'UpdateBool', @success OUT, 'callbacks[0].output[1].value', 1
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'callbacks[0].output[2].name', 'message'
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'callbacks[0].output[2].value', 'Collecting.....'
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'callbacks[0].input[0].name', 'IDToken1'
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'callbacks[0].input[0].value', '{' + CHAR(13) + CHAR(10) + '   "identifier":"aec3fe784...o3Xjiizyb9=",' + CHAR(13) + CHAR(10) + '   "alias":"Example Pixel 3 XL",' + CHAR(13) + CHAR(10) + '   "metadata":{' + CHAR(13) + CHAR(10) + '      "platform":{' + CHAR(13) + CHAR(10) + '         "platform":"Android",' + CHAR(13) + CHAR(10) + '         "version":28,' + CHAR(13) + CHAR(10) + '         "device":"generic_x86_arm",' + CHAR(13) + CHAR(10) + '         "deviceName":"AOSP on IA Emulator",' + CHAR(13) + CHAR(10) + '         "model":"AOSP on IA Emulator",' + CHAR(13) + CHAR(10) + '         "brand":"google",' + CHAR(13) + CHAR(10) + '         "locale":"en_US",' + CHAR(13) + CHAR(10) + '         "timeZone":"America/Vancouver",' + CHAR(13) + CHAR(10) + '         "jailBreakScore":1' + CHAR(13) + CHAR(10) + '      },' + CHAR(13) + CHAR(10) + '      "hardware":{' + CHAR(13) + CHAR(10) + '         "hardware":"ranchu",' + CHAR(13) + CHAR(10) + '         "manufacturer":"Google",' + CHAR(13) + CHAR(10) + '         "storage":774,' + CHAR(13) + CHAR(10) + '         "memory":1494,' + CHAR(13) + CHAR(10) + '         "cpu":4,' + CHAR(13) + CHAR(10) + '         "display":{' + CHAR(13) + CHAR(10) + '            "width":1440,' + CHAR(13) + CHAR(10) + '            "height":2621,' + CHAR(13) + CHAR(10) + '            "orientation":1' + CHAR(13) + CHAR(10) + '         },' + CHAR(13) + CHAR(10) + '         "camera":{' + CHAR(13) + CHAR(10) + '            "numberOfCameras":2' + CHAR(13) + CHAR(10) + '         }' + CHAR(13) + CHAR(10) + '      },' + CHAR(13) + CHAR(10) + '      "browser":{' + CHAR(13) + CHAR(10) + '         "agent":"Dalvik/2.1.0 (Linux; U; Android 9; AOSP on IA Emulator Build/PSR1.180720.117)"' + CHAR(13) + CHAR(10) + '      },' + CHAR(13) + CHAR(10) + '      "bluetooth":{' + CHAR(13) + CHAR(10) + '         "supported":false' + CHAR(13) + CHAR(10) + '      },' + CHAR(13) + CHAR(10) + '      "network":{' + CHAR(13) + CHAR(10) + '         "connected":true' + CHAR(13) + CHAR(10) + '      },' + CHAR(13) + CHAR(10) + '      "telephony":{' + CHAR(13) + CHAR(10) + '         "networkCountryIso":"us",' + CHAR(13) + CHAR(10) + '         "carrierName":"Android"' + CHAR(13) + CHAR(10) + '      }' + CHAR(13) + CHAR(10) + '   },' + CHAR(13) + CHAR(10) + '   "location":{' + CHAR(13) + CHAR(10) + '      "latitude":{{$randomLatitude}},' + CHAR(13) + CHAR(10) + '      "Longitude":{{$randomLongitude}}' + CHAR(13) + CHAR(10) + '   }' + CHAR(13) + CHAR(10) + '}'

    EXEC sp_OAMethod @http, 'SetRequestHeader', NULL, 'Content-Type', 'application/json'
    EXEC sp_OAMethod @http, 'SetRequestHeader', NULL, 'Accept-API-Version', 'resource=2.0, protocol=1.0'

    DECLARE @resp int
    EXEC sp_OAMethod @http, 'PostJson3', @resp OUT, 'https://<tenant-name>.forgeblocks.com/am/json/realms/root/realms/alpha/authenticate?authIndexType=service&authIndexValue=Login', 'application/json', @json
    EXEC sp_OAGetProperty @http, 'LastMethodSuccess', @iTmp0 OUT
    IF @iTmp0 = 0
      BEGIN
        EXEC sp_OAGetProperty @http, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @json
        RETURN
      END

    DECLARE @sbResponseBody int
    -- Use "Chilkat_9_5_0.StringBuilder" for versions of Chilkat < 10.0.0
    EXEC @hr = sp_OACreate 'Chilkat.StringBuilder', @sbResponseBody OUT

    EXEC sp_OAMethod @resp, 'GetBodySb', @success OUT, @sbResponseBody

    DECLARE @jResp int
    -- Use "Chilkat_9_5_0.JsonObject" for versions of Chilkat < 10.0.0
    EXEC @hr = sp_OACreate 'Chilkat.JsonObject', @jResp OUT

    EXEC sp_OAMethod @jResp, 'LoadSb', @success OUT, @sbResponseBody
    EXEC sp_OASetProperty @jResp, 'EmitCompact', 0


    PRINT 'Response Body:'
    EXEC sp_OAMethod @jResp, 'Emit', @sTmp0 OUT
    PRINT @sTmp0

    DECLARE @respStatusCode int
    EXEC sp_OAGetProperty @resp, 'StatusCode', @respStatusCode OUT

    PRINT 'Response Status Code = ' + @respStatusCode
    IF @respStatusCode >= 400
      BEGIN

        PRINT 'Response Header:'
        EXEC sp_OAGetProperty @resp, 'Header', @sTmp0 OUT
        PRINT @sTmp0

        PRINT 'Failed.'
        EXEC @hr = sp_OADestroy @resp

        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @json
        EXEC @hr = sp_OADestroy @sbResponseBody
        EXEC @hr = sp_OADestroy @jResp
        RETURN
      END
    EXEC @hr = sp_OADestroy @resp

    -- Sample JSON response:
    -- (Sample code for parsing the JSON response is shown below)

    -- {
    --   "tokenId": "N60dPV99pcqVVI.*AAJTSQACMDEAAANDVFMAAlMxAAA.*",
    --   "successUrl": "/openam/console",
    --   "realm": "/"
    -- }

    -- Sample code for parsing the JSON response...
    -- Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code

    DECLARE @tokenId nvarchar(4000)
    EXEC sp_OAMethod @jResp, 'StringOf', @tokenId OUT, 'tokenId'
    DECLARE @successUrl nvarchar(4000)
    EXEC sp_OAMethod @jResp, 'StringOf', @successUrl OUT, 'successUrl'
    DECLARE @realm nvarchar(4000)
    EXEC sp_OAMethod @jResp, 'StringOf', @realm OUT, 'realm'

    EXEC @hr = sp_OADestroy @http
    EXEC @hr = sp_OADestroy @json
    EXEC @hr = sp_OADestroy @sbResponseBody
    EXEC @hr = sp_OADestroy @jResp


END
GO

Curl Command

curl -X POST
	-H "Content-Type: application/json"
	-H "Accept-API-Version: resource=2.0, protocol=1.0"
	-d '{
    "authId": "{{authId}}",
    "callbacks": [
        {
            "type": "DeviceProfileCallback",
            "output": [
                {
                    "name": "metadata",
                    "value": true
                },
                {
                    "name": "location",
                    "value": true
                },
                {
                    "name": "message",
                    "value": "Collecting....."
                }
            ],
            "input": [
                {
                    "name": "IDToken1",
                    "value": "{\r\n   \"identifier\":\"aec3fe784...o3Xjiizyb9=\",\r\n   \"alias\":\"Example Pixel 3 XL\",\r\n   \"metadata\":{\r\n      \"platform\":{\r\n         \"platform\":\"Android\",\r\n         \"version\":28,\r\n         \"device\":\"generic_x86_arm\",\r\n         \"deviceName\":\"AOSP on IA Emulator\",\r\n         \"model\":\"AOSP on IA Emulator\",\r\n         \"brand\":\"google\",\r\n         \"locale\":\"en_US\",\r\n         \"timeZone\":\"America\/Vancouver\",\r\n         \"jailBreakScore\":1\r\n      },\r\n      \"hardware\":{\r\n         \"hardware\":\"ranchu\",\r\n         \"manufacturer\":\"Google\",\r\n         \"storage\":774,\r\n         \"memory\":1494,\r\n         \"cpu\":4,\r\n         \"display\":{\r\n            \"width\":1440,\r\n            \"height\":2621,\r\n            \"orientation\":1\r\n         },\r\n         \"camera\":{\r\n            \"numberOfCameras\":2\r\n         }\r\n      },\r\n      \"browser\":{\r\n         \"agent\":\"Dalvik\/2.1.0 (Linux; U; Android 9; AOSP on IA Emulator Build\/PSR1.180720.117)\"\r\n      },\r\n      \"bluetooth\":{\r\n         \"supported\":false\r\n      },\r\n      \"network\":{\r\n         \"connected\":true\r\n      },\r\n      \"telephony\":{\r\n         \"networkCountryIso\":\"us\",\r\n         \"carrierName\":\"Android\"\r\n      }\r\n   },\r\n   \"location\":{\r\n      \"latitude\":{{$randomLatitude}},\r\n      \"Longitude\":{{$randomLongitude}}\r\n   }\r\n}"
                }
            ]
        }
    ]
}'
https://<tenant-name>.forgeblocks.com/am/json/realms/root/realms/alpha/authenticate?authIndexType=service&authIndexValue=Login

Postman Collection Item JSON

{
  "name": "Step 2e: Handle Device Profile Callback",
  "event": [
    {
      "listen": "test",
      "script": {
        "exec": [
          "const JSONResponse = JSON.parse(responseBody);",
          "",
          "// Did request have a callback?",
          "if(JSONResponse.authId && JSONResponse.authId != \"\")",
          "{",
          "  // Set `authId` variable",
          "  pm.globals.set(\"authId\", JSONResponse.authId);",
          "  ",
          "  // Determine next request based on detected callbacks",
          "  frUtils.detectCallbacks(responseBody);",
          "}",
          "",
          "// Did request return SSO Token?",
          "if(JSONResponse.tokenId && JSONResponse.tokenId != \"\")",
          "{",
          "  // Set `demoSSOToken` variable",
          "  pm.globals.set(\"demoSSOToken\", JSONResponse.tokenId);",
          "",
          "  // Remove `authId` variable",
          "  pm.globals.unset(\"authId\");",
          "  ",
          "  // Skip to session info request",
          "  postman.setNextRequest(\"Step 3: Get Session Info\");",
          "}",
          "",
          "// Tests",
          "",
          "pm.test(\"Status code is 200\", () => {",
          "  pm.expect(pm.response.code).to.eql(200);",
          "});",
          "",
          "pm.test(\"Response contains tokenId or authId\", function () {",
          "    pm.expect(JSONResponse).to.have.any.keys('tokenId', 'authId');",
          "});",
          ""
        ],
        "type": "text/javascript"
      }
    }
  ],
  "protocolProfileBehavior": {
    "disableCookies": true
  },
  "request": {
    "method": "POST",
    "header": [
      {
        "key": "Content-Type",
        "value": "application/json",
        "description": "Specifies that the `/json/authenticate` endpoint uses JSON format for requests."
      },
      {
        "key": "Accept-API-Version",
        "value": "resource=2.0, protocol=1.0",
        "description": "Specifies the version of the `/json/authenticate` endpoint to use."
      }
    ],
    "body": {
      "mode": "raw",
      "raw": "{\n    \"authId\": \"{{authId}}\",\n    \"callbacks\": [\n        {\n            \"type\": \"DeviceProfileCallback\",\n            \"output\": [\n                {\n                    \"name\": \"metadata\",\n                    \"value\": true\n                },\n                {\n                    \"name\": \"location\",\n                    \"value\": true\n                },\n                {\n                    \"name\": \"message\",\n                    \"value\": \"Collecting.....\"\n                }\n            ],\n            \"input\": [\n                {\n                    \"name\": \"IDToken1\",\n                    \"value\": \"{\\r\\n   \\\"identifier\\\":\\\"aec3fe784...o3Xjiizyb9=\\\",\\r\\n   \\\"alias\\\":\\\"Example Pixel 3 XL\\\",\\r\\n   \\\"metadata\\\":{\\r\\n      \\\"platform\\\":{\\r\\n         \\\"platform\\\":\\\"Android\\\",\\r\\n         \\\"version\\\":28,\\r\\n         \\\"device\\\":\\\"generic_x86_arm\\\",\\r\\n         \\\"deviceName\\\":\\\"AOSP on IA Emulator\\\",\\r\\n         \\\"model\\\":\\\"AOSP on IA Emulator\\\",\\r\\n         \\\"brand\\\":\\\"google\\\",\\r\\n         \\\"locale\\\":\\\"en_US\\\",\\r\\n         \\\"timeZone\\\":\\\"America\\/Vancouver\\\",\\r\\n         \\\"jailBreakScore\\\":1\\r\\n      },\\r\\n      \\\"hardware\\\":{\\r\\n         \\\"hardware\\\":\\\"ranchu\\\",\\r\\n         \\\"manufacturer\\\":\\\"Google\\\",\\r\\n         \\\"storage\\\":774,\\r\\n         \\\"memory\\\":1494,\\r\\n         \\\"cpu\\\":4,\\r\\n         \\\"display\\\":{\\r\\n            \\\"width\\\":1440,\\r\\n            \\\"height\\\":2621,\\r\\n            \\\"orientation\\\":1\\r\\n         },\\r\\n         \\\"camera\\\":{\\r\\n            \\\"numberOfCameras\\\":2\\r\\n         }\\r\\n      },\\r\\n      \\\"browser\\\":{\\r\\n         \\\"agent\\\":\\\"Dalvik\\/2.1.0 (Linux; U; Android 9; AOSP on IA Emulator Build\\/PSR1.180720.117)\\\"\\r\\n      },\\r\\n      \\\"bluetooth\\\":{\\r\\n         \\\"supported\\\":false\\r\\n      },\\r\\n      \\\"network\\\":{\\r\\n         \\\"connected\\\":true\\r\\n      },\\r\\n      \\\"telephony\\\":{\\r\\n         \\\"networkCountryIso\\\":\\\"us\\\",\\r\\n         \\\"carrierName\\\":\\\"Android\\\"\\r\\n      }\\r\\n   },\\r\\n   \\\"location\\\":{\\r\\n      \\\"latitude\\\":{{$randomLatitude}},\\r\\n      \\\"Longitude\\\":{{$randomLongitude}}\\r\\n   }\\r\\n}\"\n                }\n            ]\n        }\n    ]\n}",
      "options": {
        "raw": {
          "language": "json"
        }
      }
    },
    "url": {
      "raw": "{{amUrl}}/json{{realm}}/authenticate?authIndexType=service&authIndexValue={{loginJourney}}",
      "host": [
        "{{amUrl}}"
      ],
      "path": [
        "json{{realm}}",
        "authenticate"
      ],
      "query": [
        {
          "key": "authIndexType",
          "value": "service",
          "description": "Allows the request to configure the service (for example, an authentication tree) to use for this request."
        },
        {
          "key": "authIndexValue",
          "value": "{{loginJourney}}",
          "description": "Specifies the name of the service to use for this request.\nOverride this value using the `amAuthenticationTree` Postman variable."
        }
      ]
    },
    "description": "To respond to a callback, send back the whole JSON object with the missing `input` values filled.\n\nThis request shows how to respond to a `DeviceProfileCallback`.\n\nThe example data in the request body represents a Google Android emulator device."
  },
  "response": [
    {
      "name": "Success - authentication complete",
      "originalRequest": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json",
            "description": "Specifies that the `/json/authenticate` endpoint uses JSON format for requests."
          },
          {
            "key": "Accept-API-Version",
            "value": "resource=2.0, protocol=1.0",
            "description": "Specifies the version of the `/json/authenticate` endpoint to use."
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n    \"authId\": \"{{authId}}\",\n    \"callbacks\": [\n        {\n            \"type\": \"ChoiceCallback\",\n            \"output\": [\n                {\n                    \"name\": \"prompt\",\n                    \"value\": \"Succeed?\"\n                },\n                {\n                    \"name\": \"choices\",\n                    \"value\": [\n                        \"Yes\",\n                        \"No\"\n                    ]\n                },\n                {\n                    \"name\": \"defaultChoice\",\n                    \"value\": 0\n                }\n            ],\n            \"input\": [\n                {\n                    \"name\": \"IDToken1\",\n                    \"value\": 0\n                }\n            ]\n        }\n    ]\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "url": {
          "raw": "{{amUrl}}/json{{realm}}/authenticate?authIndexType=service&authIndexValue={{loginJourney}}",
          "host": [
            "{{amUrl}}"
          ],
          "path": [
            "json{{realm}}",
            "authenticate"
          ],
          "query": [
            {
              "key": "authIndexType",
              "value": "service",
              "description": "Allows the request to configure the service (for example, an authentication tree) to use for this request."
            },
            {
              "key": "authIndexValue",
              "value": "{{loginJourney}}",
              "description": "Specifies the name of the service to use for this request.\nOverride this value using the `amAuthenticationTree` Postman variable."
            }
          ]
        }
      },
      "status": "OK",
      "code": 200,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "X-Frame-Options",
          "value": "SAMEORIGIN"
        },
        {
          "key": "X-Content-Type-Options",
          "value": "nosniff"
        },
        {
          "key": "Cache-Control",
          "value": "private"
        },
        {
          "key": "Cache-Control",
          "value": "no-cache, no-store, must-revalidate"
        },
        {
          "key": "Set-Cookie",
          "value": "iPlanetDirectoryPro=N60dPVcmOADQN170-8799pcqVVI.*AAJTSQACMDEAAlNLABw5QThIM0ZJd3RKcmNyWWYxSzlPaGhzcllsUXM9AAR0eXBlAANDVFMAAlMxAAA.*; Path=/; Domain=example.com; HttpOnly"
        },
        {
          "key": "Set-Cookie",
          "value": "amlbcookie=01; Path=/; Domain=example.com; HttpOnly"
        },
        {
          "key": "Content-API-Version",
          "value": "resource=2.1"
        },
        {
          "key": "Expires",
          "value": "0"
        },
        {
          "key": "Pragma",
          "value": "no-cache"
        },
        {
          "key": "Content-Type",
          "value": "application/json"
        },
        {
          "key": "Content-Length",
          "value": "167"
        },
        {
          "key": "Date",
          "value": "Wed, 12 Aug 2020 14:10:41 GMT"
        }
      ],
      "cookie": [
      ],
      "body": "{\n    \"tokenId\": \"N60dPV99pcqVVI.*AAJTSQACMDEAAANDVFMAAlMxAAA.*\",\n    \"successUrl\": \"/openam/console\",\n    \"realm\": \"/\"\n}"
    }
  ]
}