Getting Started with globaliD
globaliD allows developers to easily, safely and securely set up an identity stack. To integrate with globaliD, we'll walk you through three simple steps:
- Create a globaliD Developer Account
- Create "Apps" for your projects
- Add Features to your App
1. Create a globaliD Developer Account
A Developer account allows you to integrate globaliD's solutions.
- If you do not yet have a globaliD portable self-sovereign identity, please create one by downloading the globaliD mobile application app and selecting your unique globaliD Name.
- Navigate to the globaliD Developer Portal home page and sign in by scanning a QR code with your globaliD mobile app.
- Complete your developer profile by providing certain basic information. Please be prepared to provide an image representing your company; this should be a square .png image sized between 600 x 600 and 2000 x 2000 pixels
Once completed, you will be brought to your globaliD Developer Portal dashboard, where you will be able to see applications that you've created.
2. Create an App
globaliD supports 2 types of Apps:
Developer Apps: Uses globaliD's solution to authenticate users and to verify the aspects of their identity needed to access your services. Additionally, developer applications allow you to potentially access user personally identifiable information (PII).
Issuer Apps: Allows developers to set up new Verification Issuing App for globaliD partners to verify aspects of their users' identities.
To create a new app, navigate to "My Apps" and click Create New App
Each App that you create will generate its own
app_secret key. You will use these values in your codebase to interface with the globaliD service.
3. Adding Developer Features
Once you've set up a new App, you have the option to add Features. Features allow your service to interact with globaliD users. As a developer, you may add any of the Features:
- globaliD Connect: Allows users to sign up for and log in to your service using their globaliD mobile phone app.
- globaliD Web Client: Allow users to sign up for and log in to your service using a username and password in a web browser.
- Required Verifications: Prompts users to verify aspects of their identity.
While the Namespace API endpoints are public, others require you to have a user-specific access token in order to call them. You may acquire these access tokens by routing users to the above-mentioned globaliD Connect and globaliD Web Client Features. If you possess an access token, you can be sure that its associated user was verified through globaliD.
With the appropriate rationale and OAuth2 scope associated with your access token, and with explicit user consent, you may also be able to obtain the underlying Personal and Identifiable information (PII) about the user's identity associated with a particular verification, and/or perform actions on that user's behalf. For more information, please review the globaliD Vault and PII sharing documentation.