Because Integration is the Name of the Game

*Original post at

SkyGiraffe Integrated Web App User Guide

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.

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 orAngularJS. 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


curl –data “grant_type=password&username=xxxxxxxx&password=xxxxx&client_id=xxxxxxxxx&client_secret=xxxxxxxxxx”



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

Like what you read? Give SkyGiraffe a round of applause.

From a quick cheer to a standing ovation, clap to show how much you enjoyed this story.