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.
A few specific situations where SGIWA is a great tool:
- When you need to provide secure, mobile access to an existing web app.
- 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).
- When you’re dealing with completely custom requirements, for example a traditional workflow with custom buttons, navigations, messaging etc.
Here are the technical steps to create a SGIWA:
- Obtain the authorization server and publisher URLs.
- Authenticate your user to get access token and refresh token. For SkyGiraffe Authentication, the authorization request requires the following parameters:
curl –data “grant_type=password&username=xxxxxxxx&password=xxxxx&client_id=xxxxxxxxx&client_secret=xxxxxxxxxx” https://skygiraffeauthorizationserver.skygiraffe.com/oauth2/token
For other custom authentication methods, there should be a similar request as well. You will need to follow the external authentication specs.
- 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 firstname.lastname@example.org.