Managing User Profiles

User Profiles are core to how Sahha works. Each User Profile is associated with a health analysis and corresponding sensor, and health data. This guide will teach you how to create, authenticate and manage user profiles.

---

Authenticating User Profiles

The Sahha SDK must be authenticated in order to connect to the Sahha API. Do this once per user profile. Once a profile is authenticated, the SDK will take care of automatically issuing and refreshing API tokens.

But before we start authenticating User Profiles you need to know how to use the ExternalID field

Using the External ID

You will need to provide your own unique External ID to authenticate a user profile. An External ID can be any string you choose to identify a user profile within your organization. This ID must be unique for each of your users. This ID has a limit of 100 characters.

We suggest using an anonymous UUID e.g. 123e4567-e89b-12d3-a456-426614174000

If your user changes devices, make sure to use the same External ID to identify them on the new device.

Now that you know how to use the ExternalID you can start authenticating User Profiles.

---

Authenticate Profiles via SDK

The fastest way to authenticate a User Profile is via the Sahha SDK. You will need your appID and appSecret to authenticate user profiles with an External ID which you can get from your Sahha Dashboard under the API keys tab.

• iOS

• Android

• Flutter

• React Native

Sahha.authenticate(appId: "APP_ID", appSecret:  "APP_SECRET", externalId: "EXTERNAL_ID") { error, success ->
    if (success) greeting = "Successful"
    else greeting = error ?: "Failed"
}

Authenticate Profiles via API

You can also authenticate a user profile via the API and then pass the Profile Token to the SDK.

View the API docs: API - Authenticate User Profile

Step 1) Use your accountToken and externalId to authenticate a user profile via the profile/register endpoint.

// POST "/oauth/profile/register"
// AUTHORIZATION HEADER "Account MY_ACCOUNT_TOKEN"

// BODY
{
	"externalId": "MY_EXTERNAL_ID"
}

You will receive a profileToken and refreshToken in the API response.

// POST "/oauth/profile/register"
// AUTHORIZATION HEADER "Account MY_ACCOUNT_TOKEN"

// BODY
{
	"profileToken": "PROFILE_TOKEN",
	"expiresIn": "86400",
	"tokenType": "Profile",
	"refreshToken": "REFRESH_TOKEN"
}

Step 2) Pass the profileToken and refreshToken you generated via the API to the SDK.

• iOS

• Android

• Flutter

• React Native

Sahha.authenticate(profileToken: "PROFILE_TOKEN", refreshToken:  "REFRESH_TOKEN") { error, success ->
    if (success) greeting = "Successful"
    else greeting = error ?: "Failed"
}

---

Deauthenticate

If you would like to change authenticated users, first deauthenticate the current user before authenticating a new user.

The SDK will take care of switching user data and automatically issuing and refreshing API tokens.

• iOS

• Android

• Flutter

• React Native

Sahha.deauthenticate { error, success ->
    if (success) farewell = "Successful"
    else farewell = error ?: "Failed"
}

---

Check Authentication

You can easily check if a profile is already authenticated via the SDK.

• iOS

• Android

• Flutter

• React Native

if Sahha.isAuthenticated {
  	print("Profile is ready")
} else {
 	print("You must authenticate your profile")
}

---

Get Profile Token

You can get the currently authenticated user's profile token.

• iOS

• Android

• Flutter

• React Native

val token = Sahha.profileToken;
if (token != null) {
    print("Profile is ready")
} else {
    print("You must authenticate your profile")
}