Manage Projects

A project is a container for the HERE platform resources you use to build an app, service, or other work product. It can contain resources such as catalogs, pipelines, schemas, and services. The project controls which users, apps, and groups can access the resources in the project. We recommend that you use projects to manage all your platform resources.

Why use projects?

Some benefits of using projects include:

  • Collaboration: Work only in the context of the resources that matter to your team, and help other teams by sharing useful resources with them in a controlled manner (bidirectional trust).
  • Workflow management: Accommodate different access requirements for dev, test, and production environments.
  • Access management: Control access to individual resources by assigning permissions to users, groups, or apps.
  • Cost tracking: Track resource usage by project in the platform Usage report so you know how much an app or use case is costing.

Note

When you work with projects you will notice the project context is displayed in the portal. For example:

Project context image
Figure 1. Project context image

You may change the project context to another project, opt to view all projects or simply remove the project context filter altogether depending on what resources you’re interested in.

Create a project

To create a project, follow these steps:

  1. Sign in to the HERE platform.
  2. Open the Projects Manager from the launcher.
  3. Click Create new project.
  4. Enter a name for the project (project names don't have to be unique).
  5. Enter a project ID. Project IDs must be unique with an org and cannot be changed for the lifetime of the org. Project IDs must be between 4 and 16 characters in length.
  6. Enter an optional description.
  7. Click Save.

You have admin rights to the project you created. You can grant admin rights to other users and apps. For instructions, see Grant or revoke project admin permissions.

Note

Org admins can manage all projects, even if they haven’t been explicitly granted project admin permissions.

Manage access to a project

Grant access to a project

  1. Sign in to the HERE platform.
  2. In the Projects Manager, click the project to which you want to give a user, group or an app access. Select the Access and permissions tab to view a list of users, groups and apps with access to the project.
  3. Click Grant access.
  4. Select if you want to search by existing groups or existing users and apps.
  5. Enter the name in the search field to find the desired user, group or app by name.
  6. Select the desired name and click Grant access. The name is now listed.
  7. Alternatively, you can use the links on the Grant access to a project window to create new users, groups, or apps in the Access Manager. When creating an app this way, the default project for the app will automatically be set to the project you were working in and optionally set to only allow access in the default project.

Note

By default, all members of the project (including users, groups, and apps) will have access to all resources in the project. You can set up granular access to project resources through platform policies and custom policies using the Command Line Interface (CLI). For more information, see Projects Workflows in the Command Line Interface User Guide.

Remove access to a project

  1. Sign in to the HERE platform.
  2. In the Projects Manager, click the project from which you want to remove access for a user, group or an app. Select the Access and permissions tab to view a list of users, groups and apps with access to the project.
  3. Click the three dots menu to remove the user, group or app access to the project. A Remove from project button appears.
  4. On the popup dialog, click Remove to confirm.

Specify a default project for an app

App managers can specify a default project for the app. To set the default project for the app, go to the app details page and select the Edit app menu option. Subsequently selecting a project in the dialog will set that project as the default project scope for the app.

You can also set the app to only request resources in the scope of the default project. This setting is recommended for apps using API keys because it helps secure the use of your API keys. It also allows you to track usage by project for an app using an API key.

Note

Apps set to only request resources in the scope of the default project cannot be added to groups. This is to prevent the app from inadvertently becoming a member of other projects (via its group membership) where it won't work since it's restricted to use in another project.

If you need to use an app across multiple projects, for example to orchestrate CI/CD processes, we recommend you use OAuth tokens and set the project scope as needed when requesting the token.

Grant or revoke project admin permissions

Only org and project admins can change a user's project permissions. Org admins can change user permissions on any project. Project admins can change user permissions only on those projects for which they have admin permissions.

  1. Sign in to the HERE platform.
  2. Click on the Access and Permissions tab of your project to view a list of users, apps and groups with access to the project.
  3. Click the three dots menu to change project admin permissions for a user or an app. A Make project admin button appears if the user or app is not already an admin. A Revoke project admin button appears if the user or app is an admin. Clicking the appropriate button will immediately change the project admin permissions for the user or app.

Note

While an app cannot be given org admin or group admin rights, you can make an app a project admin in the same manner as you make a user a project admin. Groups cannot be project admins.

Manage resources in a project

From within a platform project you can create, delete, link, and share resources in a controlled manner. This is the recommended way to manage access to resources. The following sections provide instructions on how to manage project resources by resource type.

Catalogs

Add a catalog to a project

There are multiple ways to add a catalog to a project. You can create a new catalog in a project, link to an existing HERE catalog from a project, or link to a catalog that's been created in another project in your org and made available to link, designated as "shared," to your project.

  1. Sign in to the HERE platform.
  2. In the Projects Manager, click the project to which you want to add a catalog and select the Resources tab.
  3. Click Add catalog and choose one of the following options:
    • Link a catalog: Choose this option to add an existing catalog to the project. You are presented with a list of catalogs provided by HERE, as well as catalogs from other project(s) within your organization. Click the Link button for the desired catalog. If a choice is available, select the permissions for the catalog, for example "read" and "write". The catalog will appear in your list of project catalogs with a link icon next to the catalog name and the linked permissions.
    • Create a new catalog: Choose this option to create a new catalog and add it to the project. Complete all of the required fields. For more information, see Create a catalog in the Data User Guide. Ensure that you leave the Create catalog in a project option selected and validate the Home Project field matches the name of the project you want the catalog to be created in. When you are done, click Save.

Remove a catalog from a project

  1. Sign in to the HERE platform.
  2. In the Projects Manager, click the project from which you want to remove a catalog and select the Resources tab.
  3. Click on the three dots and select Unlink.

Share a catalog

Sharing a catalog makes it available to link to other projects in your organization. You may choose to make the catalog available to all or specified projects within your organization with permissions that you set ("read" and/or "write"). Once you make the catalog available, you can link to it by following the instructions in Add a catalog to a project.

  1. Sign in to the HERE platform
  2. In the Projects Manager, click the project that contains the catalog you want to share with one or more projects in your organization.
  3. Click the three dots next to the catalog you would like to share and select Set catalog availability.
  4. Specify the project to which you want to share the catalog or choose Make available to all projects in your organization.
  5. Specify the permissions to the catalog you want to share: read and/or write.
  6. Click Set.

The steps above describe this functionality in the context of Projects Manager. This functionality is also accessible to users with manage access to a catalog from the catalog detail page in the Data section of the portal. In addition, users with manage access to a catalog can unlink that catalog from a project from the Availability tab of the catalog detail page in the Data section of the portal. The steps for all of these actions are described in the Data User Guide.

Disable sharing for a catalog

To make a catalog unavailable to link to projects, follow these steps:

  1. Sign in to the HERE platform
  2. In the Projects Manager, click the project that contains the catalog you want to modify.
  3. Click the three dots next to the catalog and select Set catalog availability.
  4. De-select Make available to all projects in your organization.
  5. Click Set.

Note

Disabling catalog sharing does not unlink it from projects to which it is already linked. A user with manage access to the catalog can unlink it from a project from the Availability tab of the catalog detail page in the Data section of the portal as described in the Data User Guide.

Change permissions to a shared catalog

To change the available permissions to a catalog after you have shared it, follow these steps:

  1. Sign in to the HERE platform
  2. In the Projects Manager, click the project that contains the catalog you want to modify.
  3. Click the three dots next to the catalog and select Set catalog availability.
  4. Change the permissions by selecting the desired checkboxes.
  5. Click Set.

Note

Changing a catalog's permissions in a project will not change the permissions to the catalog for any project that has already linked to the catalog.

Schemas

Add a schema to a project

There are multiple ways to add a schema to a project. You can create a new schema in a project, link to an existing HERE schema from a project, or link to a schema that's been created in another project in your org and made available to link, designated as "shared," to your project. Linking schemas, whether user or HERE created, is currently only supported via the CLI.

To create a new schema in a project, you must associate the schema with the project when you create the schema's Maven project using the HERE Data SDK for Java and Scala. To associate the schema with a project, specify the project's HERE resource number (HRN) in the here.token.scope property in your local ~/.here/credentials.properties file before you deploy the Maven project. Then, when you deploy the Maven project containing the schema, the schema deployment plugins will create the schema in the specified HERE platform project. For more information, see Create and Extend Schemas.

After you deploy the schema, it is listed in the project on the Resources tab, in the Schemas section.

Note

Schemas associated with catalogs that are linked to a project are not listed in the Schemas section of the Resources tab. You can view them by navigating to the Data section of the portal, selecting Schemas, and then selecting the project you want from the dropdown menu in the top right corner of the window.

To link a schema that's been shared to a project, see the CLI documentation here.

Share a schema (CLI-only functionality)

Sharing a schema makes it available to link to other projects in your organization. You may choose to make the schema available to all or specified projects within your organization with "read" permissions. For more information, see the CLI documentation here.

Once you share a schema, an app in the project to which it has been shared can link to the schema. For more information, see the CLI documentation here.

Pipelines

Add a pipeline to a project

To add a pipeline to a project, you must create the pipeline in a project. You cannot link an existing pipeline to a project.

To create a new pipeline and add it to a project, follow these steps:

  1. Sign in to the HERE platform.
  2. In the Projects Manager, click the project to which you want to add a pipeline.
  3. On the Resources tab, click Pipelines.
  4. Click Create new pipeline.
  5. Complete all of the required fields. Ensure that you leave the Create pipeline in a project option selected and validate the Home Project field matches the name of the project you want the pipeline to be created in. For more information, see Using the Web Portal for Pipelines in the Pipeline Developer Guide.
  6. Click Save Version.

Project limits

Constraint Limit
Maximum number of users/apps in a project 500
Maximum number of groups in a project 100
Maximum number of projects a group, user, or app can have direct access to 50
Maximum number of resources in a project 100

Projects and the CLI

The information in this section describes how to use projects in the platform portal. You can also use the CLI to work with projects. For more information, see Project Workflows in the Command Line Interface User Guide.

results matching ""

    No results matching ""