Get Your Credentials

You require two sets of credentials.

  • To authenticate with the HERE platform, you need platform credentials. In addition, you also need credentials to upload schemas.
  • To download the HERE Data SDK for Java & Scala libraries, archetypes, and example code to your environment, you need repository credentials.

The following instructions describe how to obtain both sets of credentials.

Before you can get any credentials, you need to create an app. The HERE platform uses the concept of an app to control access to the platform resources.

Note: App Access to Resources

Additionally, your app needs to have the correct permissions for the catalogs and layers that you intend to work with. These permissions are granted by the catalog owner. For more information on how to manage permissions, see the Teams and Permissions User Guide.

Download Your Credentials

To create an app, log into your HERE account and perform the following steps:

  1. Create a .here directory in your home directory.
    • For Mac/Linux users, this would be $HOME/.here .
    • For Windows users, this would be C:\%HOMEPATH%\.here (if your home directory is on your C drive).
  2. Browse to Apps.
  3. Click Register new app and provide the requested information.
  4. Click Register.
    • A new app with a unique access key is created. For more information, see Get Credentials

To download your credentials, perform the following steps:

  1. In the portal, select Launcher > Access Manager, go to the Apps tab, and select your app.
  2. In the Credentials tab, go to the OAuth 2.0 tab and click Create credentials.
  3. In the dialog box that opens, click Download.

    Note: Important

    Once you click Close, you can no longer access your access key ID and access key secret.

  4. Copy the resulting credentials.properties file to the .here directory that you created before.

    This credentials.properties file contains your credentials. The OLP CLI and libraries use this file to manage access.

Note that you can download this file only once. The portal only prompts you to download this file once, so keep it in a safe place. If you return to the portal later, you won't be able to download another credentials file for the same key. You'll have to create another key instead.

To download your repository credentials, do the following:

  1. Go to your profile menu, select Repository, and click Create credentials.
  2. Download the settings.xml file that contains your repository credentials and save it in your Maven settings directory. For more information on using the settings file, see the Maven documentation.

Note: Tip

As noted by Maven, the usage of a repository manager is considered an essential best practice. It can offer many benefits including an improved build, particularly any initial ones that require dependency downloads. If your company has set up a repository manager, you should edit the repositories element in the downloaded settings.xml to use it.

Your app and associated credentials do not inherit your user permissions or your group memberships. You have to assign permissions and group membership in the Sharing tab.

You can only create two keys per app.

Note: Important

App credentials are valid until you delete your app or delete or disable the access key.

To authenticate with the HERE platform through an API, see the Authentication and Authorization API Developer's Guide. Before you can use this API, you need to get the credentials.properties file.

results matching ""

    No results matching ""