Authenticate to the HERE platform

To authenticate to the HERE platform and start working with HERE Data SDK for C++, you need to get an access token. You can receive it using a default token provider, project authentication, or federated credentials.

For instructions, see the OAuth tokens section in the Identity & Access Management Developer Guide.

Authenticate using a default token provider

1. Get your platform credentials.

   For instructions, see the Register your application section in the Identity & Access Management Developer Guide.

   You get the credentials.properties file.

2. Initialize the authentification settings using the here.access.key.іd and here.access.key.secret from the credentials.properties file as kKeyId and kKeySecret respectively.

   Note

   You can also retrieve your credentials from the credentials.properties file using the ReadFromFile method. For more information, see the related API documentation.

   olp::authentication::Settings settings({kKeyId, kKeySecret});
   settings.task_scheduler = task_scheduler;
   settings.network_request_handler = http_client;
   

3. Set up the AuthenticationSettings object with a default token provider.

   olp::client::AuthenticationSettings auth_settings;
   auth_settings.provider =
     olp::authentication::TokenProviderDefault(std::move(settings));
   

You get an access token.

You can use the AuthenticationSettings object to create the OlpClientSettings object. For more information, see the related section in the Developer Guide.

Authenticate using project authentication

1. Get your platform credentials.

   For instructions, see the Register your application section in the Identity & Access Management Developer Guide.

2. Initialize the AuthenticationCredentials class using the here.access.key.іd and here.access.key.secret from the credentials.properties file as kKeyId and kKeySecret respectively.

   Note

   You can also retrieve your credentials from the credentials.properties file using the ReadFromFile method. For more information, see the related API documentation.

   olp::authentication::AuthenticationCredentials credentials(kKeyId, kKeySecret);
   

3. Create an authentication client.

   olp::authentication::AuthenticationSettings settings;
   settings.task_scheduler = task_scheduler;
   settings.network_request_handler = http_client;
   authentication::AutnhentucationClient client(settings);
   

4. Create the SignInProperties object with your project ID.

   authentication::SignInProperties signin_properties;
   signin_properties.scope = "<project ID>";
   

5. Create the SignInClient object.

   authentication:: SignInClient(AuthenticationCredentials credentials,
                                         SignInProperties properties,
                                         SignInClientCallback callback);
   

You get an access token.

You can use the AuthenticationSettings object to create the OlpClientSettings object. For more information, see the related section in the Developer Guide.

Authenticate using federated credentials

1. Get your platform credentials.

   For instructions, see the Register your application section in the Identity & Access Management Developer Guide.

   You get the credentials.properties file.

2. Initialize the AuthenticationCredentials class using the here.access.key.іd and here.access.key.secret from the credentials.properties file as kKeyId and kKeySecret respectively.

   Note

   You can also retrieve your credentials from the credentials.properties file using the ReadFromFile method. For more information, see the related API documentation.

   olp::authentication::AuthenticationCredentials credentials(kKeyId, kKeySecret);
   

3. Create an authentication client.

   olp::authentication::AuthenticationSettings settings;
   settings.task_scheduler = task_scheduler;
   settings.network_request_handler = http_client;
   authentication::AutnhentucationClient client(settings);
   

4. Get your federated (Facebook or ArcGIS) properties.

   You should have at least your federated access token. For the complete list of federated properties, see the related documentation.

5. Initialize your federated properties.

   olp::authentication::AunthenticationClient::FederatedProperties properties;
   properties.access_token = "your-access-token";
   

6. Create the SignInUserCallback class.

   For more information, see the AuthenticationClient reference documentation.

7. Create your own token provider using the authentication client created in step 3, your federated credentials, and the SignInUserCallback class.

   Note

   You can call your custom token provider form different threads.

   auto token = std::make_shared<std::string>();
   
   settings.provider = [token](){
   if (token->empty() || isExpired(token)) {
   std::promise<AuthenticationClient::SignInUserResponse> token_promise;
   
   auto callback = [&token_promise](AuthenticationClient::SignInUserResponse response)
      { token_promise.set(response); };
   
   authentication::AutnhentucationClient client(settings);
   client.SignInFacebook(credentials, properties, callback);
   auto response = token_promise.get_future().get();
   (*token) = response.GetResult().GetAccessToken();
   }
   return *token;
   }
   

You get an access token. By default, it expires in 24 hours. To continue working with the HERE platform after your token expires, generate a new access token.

You can use the AuthenticationSettings object to create the OlpClientSettings object. For more information, see the related section in the Developer Guide.