User Onboarding

The goal is to implement PDA Auth screens in a simplified style with less visual clutter.
PDA Auth includes the following screens:
email/password collection for signup
email/password collection for login
password recovery and reset screen
HMIC screen
Registration
To use the new PDA Auth flow you will first need to redirect the user where they can give their consent to complete the registration.
You can do this by building the signup URL using your application_id and redirect_uri. See below for an example, these parameters are required:
1
https://auth.dataswift.io/services/signup?
2
  application_id=<application-id>
3
  &redirect_uri=<redirect-uri>
Copied!
There are two optional query parameters as well:
lang
Defaults to en. 
If you pass a different country code by using lang=<country-code>,
the application will appear localized to the requested language, for example: lang=pt
skip_deps
Defaults to false. 
This flag allows control over how the platform handles downline dependencies of your
application. If, for example, your application depends on a DataPlug to provide data that
your application can use, the default behaviour of skip_deps=false will automatically send the user to the appropriate service to enable the DataPlug.
We now support an option for the developer to skip the latter step by using skip_deps=trueflag passed to the API as a query parameter. When the flag is added, the platform will create a PDA for the user, but will skip the data synchronization setup. In this case, it is up to the developer to decide how they want to handle data synchronization setup in the future.
Upon successful signup, the user will be redirected back to your application with the authentication token attached. This should be stored for subsequent API calls:
1
test-app://authenticate?token=eyJ0eXAiOiJKV1Qi….
Copied!
Authentication
To use PDA Auth authorization, you will need to redirect the user to where they can enter their password and complete the process.
You’ll need to build the URL using your Application ID, and a redirect URI. The URL will look similar to this:
1
https://auth.dataswift.io/services/login?
2
  application_id=<application-id>
3
  &redirect_uri=<redirect-uri>
Copied!
Optional configuration query parameters:
lang
Defaults to en. 
If you pass a different country code by using lang=<country-code>,
the application will appear localized to the requested language, for example: lang=pt
Upon successful login, the server will verify if the application has been granted all the permissions it needs. If not, the user will need to do so for the app to access their PDA.
Lastly, the user will be redirected back to your application with the authentication token attached. This should be stored for subsequent API calls:
1
test-app://authenticate?token=eyJ0eXAiOiJKV1Qi….
Copied!
Email Verification
Upon successful registration, the user will receive an email to verify their email address and create a password. The user will be redirected to the PDA Dashboard by clicking the link with the unique token.
1
https://<pda-user-url>/auth/verify-email/<verification-token>?
2
  email=<email-address>
3
  &application_id=<application-id>
4
  &redirect_uri=<redirect-uri>
Copied!
​

Build on Dataswift One - Previous

User Journeys

Password Management

Last modified 21d ago

Copy link

Contents

Registration

Authentication

Email Verification