SkyGiraffe Integrated Web App User Guide

by Itay Braun | Nov 11, 2016

With our latest version of SkyGiraffe, we added a new “Integrated Web App” feature (SGIWA). Because we think it’s a particularly useful addition, we wanted to provide a quick overview, along with a step-by-step guide to implementing the SGIWA.

integrated-web-app-url-tab

What is a SGIWA

SGIWA is a Web browser app that consumes SkyGiraffe APIs for authentication and retrieval/write-back of data. Because this app is authenticated by SkyGiraffe, you can access it seamlessly within the SkyGiraffe mobile application.

Use cases

A few specific situations where SGIWA is a great tool:

  1. When you need to provide secure, mobile access to an existing web app.
  2. When you need a custom UI for an app (e.g. showing a calendar view which may not be an out of the box SkyGiraffe template).
  3. When you’re dealing with completely custom requirements, for example a traditional workflow with custom buttons, navigations, messaging etc.

Technology requirements

SGIWA is a REST Web service client. It can be developed using javascript frameworks like node.js or AngularJS. Any other programming/scripting language can also be used per the developer’s preferences.

Step-by-step guide

Here are the technical steps to create a SGIWA:

  1. Obtain the authorization server and publisher URLs.
  2. Authenticate your user to get access token and refresh token. For SkyGiraffe Authentication, the authorization request requires the following parameters:
  • Username
  • Password
  • ClientId
  • ClientSecret

Request

curl –data “grant_type=password&username=xxxxxxxx&password=xxxxx&client_id=xxxxxxxxx&client_secret=xxxxxxxxxx” https://skygiraffeauthorizationserver.skygiraffe.com/oauth2/token

Response

{“access_token”:”xxxxxxxxxxx”,”token_type”:”bearer”,”expires_in”:3599,”refresh_token”:”xxxxx”}

For other custom authentication methods, there should be a similar request as well. You will need to follow the external authentication specs.

  1. You can make subsequent requests to get applications, reports and writebacks as the case may be. The access token is sent as an authentication header.

The REST spec is here.  

For more information or to request access to SGIWA, or to learn more about our platform, please email [email protected].

Recent Posts