Manage Dev Portal Teams

In Gateway Manager, select a control plane and follow these steps:

1. Select Gateway Services from the side navigation bar, then New Gateway Service.
2. From the Add a Gateway Service dialog, enter the following to create a new service:
   • Name: pizza_ordering
   • Upstream URL: http://mockbin.org
   • Use the defaults for the remaining fields.
3. Click Save.
4. To create an API product for your service, navigate to API Products in the sidebar, click Add API Product and enter Pizza Ordering in the Product Name field.
5. Click Publish to portal from the Actions dropdown menu. This will allow developers to access the API product once you assign them to a team.
6. Click New Version from the Actions dropdown menu and enter v1 in the Version Name field and then click Create.
7. Click the v1 version and then click Link to add a service.
8. Select a control plane from the Select Control Plane dropdown menu, select pizza_ordering from the Gateway Service dropdown menu, and then click Save.
9. Click the Edit icon next to the status of your product version and select Published from the Edit version status dialog and then click Save.
10. You need to enable app registration if you want the developer in the Authorized Delivery Partners group to be able to consume your APIs by registering apps. You can use an authentication method of your choice in the enable or disable application registration documentation.

You now have a published API product for your Pizza Ordering API in your Dev Portal.

The Konnect API uses Personal Access Token (PAT) authentication. You can obtain your PAT from the personal access token page. The PAT must be passed in the Authorization header of all requests.

1. Create the pizza_ordering service:

    curl --request POST \
      --url https://{region}.api.konghq.com/v2/control-planes/{controlPlaneId}/core-entities/services \
      --header 'Authorization: Bearer <personal-access-token>' \
      --header 'Content-Type: application/json' \
      --header 'accept: application/json' \
      --data '{
          "name": "pizza_ordering",
          "host": "mockbin.org",
          "path": "/pizza_ordering"
      }'
   

   You can get the controlPlaneId by using the list control planes endpoint to list all control planes and their IDs.

   You should get a 201 response like the following:

    {
        "connect_timeout": 60000,
        "created_at": 1692885974,
        "enabled": true,
        "host": "mockbin.org",
        "id": "06acc4f4-c6d8-4daf-bef6-79866e88ca86",
        "name": "pizza_ordering",
        "path": "/pizza_ordering",
        "port": 80,
        "protocol": "http",
        "read_timeout": 60000,
        "retries": 5,
        "updated_at": 1692885974,
        "write_timeout": 60000
    }
   

   Save the id value from the output. This is your GATEWAY-SERVICE-ID and will be used in another step.

2. Create the Pizza Ordering API product:

    curl --request POST \
      --url https://{region}.api.konghq.com/v2/api-products \
      --header 'Authorization: Bearer <personal-access-token>' \
      --header 'Content-Type: application/json' \
      --header 'accept: application/json' \
      --data '{
          "name": "Pizza Ordering",
          "description": "API product for pizza ordering"
      }'
   

   You should get a 201 response like the following:

    {
        "labels": {},
        "id": "0429aa6b-d789-4c73-bbb1-73a228c69477",
        "name": "Pizza Ordering",
        "description": "API product for pizza ordering",
        "portal_ids": [],
        "created_at": "2023-01-01T00:00:00.000Z",
        "updated_at": "2023-01-01T00:00:00.000Z"
    }
   

   Save the id value from the output. This is your api-product-id and will be used in another step.

3. Using theapi-product-id of the newly created API product, publish the Pizza Ordering API product:

    curl --request PATCH \
      --url https://{region}.api.konghq.com/v2/api-products/{apiProductId} \
      --header 'Authorization: Bearer <personal-access-token>' \
      --header 'Content-Type: application/json' \
      --header 'accept: application/json' \
      --data '{
      "portal_ids":[
        "DEV_PORTAL_ID"
      ]
    }'
   

   The DEV_PORTAL_ID can be found in the Konnect UI in the Dev Portal section.

   You should get a 200 response like the following:

    {
        "labels": {},
        "id": "38219b88-28fb-4a51-aaca-ea5b931939d8",
        "name": "Pizza Ordering",
        "description": "API product for pizza ordering",
        "portal_ids": [
          "a060b86d-593b-4e7e-9cc4-188d2f13265e"
        ],
        "created_at": "2023-01-01T00:00:00.000Z",
        "updated_at": "2023-01-01T00:00:00.000Z"
    }
   

4. Using theapi-product-id of the newly created API product, create a v1 version for the Pizza Ordering API product and publish it:

    curl --request POST \
      --url https://{region}.api.konghq.com/v2/api-products/{apiProductId}/product-versions \
      --header 'Authorization: Bearer <personal-access-token>' \
      --header 'Content-Type: application/json' \
      --header 'accept: application/json' \
      --data '{
      "name":"v1",
      "publish_status":"published",
      "gateway_service":{
        "control_plane_id":"CONTROL_PLANE_ID",
        "id":"GATEWAY_SERVICE_ID"
        }
      }'
   

   You should get a 201 response like the following:

    {
        "id": "0a8eebb6-0ed4-4382-c366-c1f4ea01f295",
        "name": "v1",
        "publish_status": "published",
        "deprecated": false,
        "created_at": "2023-01-01T00:00:00.000Z",
        "updated_at": "2023-01-01T00:00:00.000Z",
        "gateway_service": {
          "id": "0f5a6eaa-1267-4259-b226-fd2520926ee2",
          "control_plane_id": "5b32f5e1-6c0e-448d-bd94-14c770c4ffbd"
        }
    }
   

5. You need to enable app registration if you want the developer in the Authorized Delivery Partners group to be able to consume your APIs by registering apps. Currently, the only way to enable app registration is by using the Konnect UI. You can use an authentication method of your choice in the enable or disable application registration documentation.

You now have a published API product for your Pizza Ordering API in your Dev Portal.

So far, you’ve used the following endpoints:

• Create a new service
• Create API product
• Update an individual API product
• Create API product version specification

Review the API documentation to see what other features are available.

1. From the navigation menu, open Dev Portal.
2. Click Teams in the sidebar and then click Add team.
3. Enter the following:
   • Team name: Authorized Delivery Partners
   • Description: Team of vetted delivery partners that can view and consume APIs
4. On the Developers tab of your new team, click Add developer and select a test developer to add to the team.
5. On the Products tab of your new team, click Add Role.
6. Select the Pizza Ordering product from the dropdown menu and select API Consumer and API Viewer from the Add roles dropdown menu.
7. Click Teams in the sidebar and click New Team again and enter the following:
   • Team name: Prospective Partners
   • Description: Team of unvetted partners that can only view APIs
8. On the Developers tab of your new team, click Add developer and select a test developer to add to the team.
9. On the Products tab of your new team, click Add Role.
10. Select the Pizza Ordering product from the dropdown menu and select API Viewer from the Add roles dropdown menu.

You now have added your test developer accounts to two teams with different access permissions for your Dev Portal. These developers won’t be able to access anything in Dev Portal yet, though, because we need to enable Portal RBAC next.

The Konnect API uses Personal Access Token (PAT) authentication. You can obtain your PAT from the personal access token page. The PAT must be passed in the Authorization header of all requests.

1. Create the Authorized Delivery Partners team:

    curl --request POST \
      --url https://{region}.api.konghq.com/v2/portals/{portal-id}/teams \
      --header 'Authorization: Bearer <personal-access-token>' \
      --header 'Content-Type: application/json' \
      --header 'accept: application/json' \
      --data '{
      "name": "Authorized Delivery Partners",
      "description": "Team of vetted delivery partners that can view and consume APIs"
      }'
   

   The portal-id can be found in the Konnect UI in the Dev Portal section.

   You should get a 201 response like the following:

    {
        "id": "4bfe2ae8-42d9-46a3-a5de-80b054ae8a44",
        "name": "Authorized Delivery Partners",
        "description": "Team of vetted delivery partners that can view and consume APIs",
        "created_at": "2023-01-01T00:00:00.000Z",
        "updated_at": "2023-01-01T00:00:00.000Z"
    }
   

   The portal-id will be the value from the output of the request you used earlier to create the Pizza Delivery API product.

   Save the id value from the output. This is your teamId for the Authorized Delivery Partners team and will be used in another step.

2. Create the Prospective Partners team:

    curl --request POST \
      --url https://{region}.api.konghq.com/v2/portals/{portal-id}/teams \
      --header 'Authorization: Bearer <personal-access-token>' \
      --header 'Content-Type: application/json' \
      --header 'accept: application/json' \
      --data '{
      "name": "Prospective Partners",
      "description": "Team of unvetted partners that can only view APIs"
      }'
   

   The portal-id can be found in the Konnect UI in the Dev Portal section.

   You should get a 201 response like the following:

    {
        "id": "4bfe2ae8-42d9-46a5-a5de-80b054ae8a44",
        "name": "Prospective Partners",
        "description": "Team of unvetted partners that can only view APIs",
        "created_at": "2023-01-01T00:00:00.000Z",
        "updated_at": "2023-01-01T00:00:00.000Z"
    }
   

   Save the id value from the output. This is your teamId for the Prospective Partners team and will be used in another step.

3. Assign the API Consumer role to the Authorized Delivery Partners created in the previous section for your pizza ordering API product:

    curl --request POST \
      --url https://{region}.api.konghq.com/v2/portals/{portal-id}/teams/{team-id}/assigned-roles \
      --header 'Authorization: Bearer <personal-access-token>' \
      --header 'Content-Type: application/json' \
      --header 'accept: application/json' \
      --data '{
      "role_name": "API Consumer",
      "entity_id": "GATEWAY_SERVICE_ID",
      "entity_type_name": "Services"
      }'
   

   The portal-id can be found in the Konnect UI in the Dev Portal section.

   You should get a 201 response like the following:

    {
        "id": "091260a3-1e96-40c9-86c2-c7cbe795dfdb",
        "role_name": "API Consumer",
        "entity_id": "0f5a6eaa-1967-4269-b226-fd2520926ee2",
        "entity_type_name": "Services",
        "entity_region": "us"
    }
   

4. Now assign the API Viewer role to the Prospective Partners team for the same pizza ordering API product:

    curl --request POST \
      --url https://{region}.api.konghq.com/v2/portals/{portal-id}/teams/{team-id}/assigned-roles \
      --header 'Authorization: Bearer <personal-access-token>' \
      --header 'Content-Type: application/json' \
      --header 'accept: application/json' \
      --data '{
      "role_name": "API Viewer",
      "entity_id": "GATEWAY_SERVICE_ID",
      "entity_type_name": "Services",
      "entity_region": "us"
      }'
   

   The portal-id can be found in the Konnect UI in the Dev Portal section.

   You should get a 201 response like the following:

    {
        "id": "091268a3-1e96-40c9-86c2-c7cbe795dfdb",
        "role_name": "API Viewer",
        "entity_id": "0f5a6eac-1967-4269-b226-fd2520926ee2",
        "entity_type_name": "Services",
        "entity_region": "us"
    }
   

5. Add a test developer to the Authorized Delivery Partners team:

    curl --request POST \
      --url https://{region}.api.konghq.com/v2/portals/{portalId}/teams/{teamId}/developers \
      --header 'Authorization: Bearer <personal-access-token>' \
      --header 'Content-Type: application/json' \
      --data '{"id":"DEVELOPER-ID"}'
   

   If you don’t remember the IDs for your test developers, you can send a GET request to list developers.

   You should get a 201 response like the following:

    Created
   

6. Add a test developer to the Prospective Partners team:

    curl --request POST \
      --url https://{region}.api.konghq.com/v2/portals/{portalId}/teams/{teamId}/developers \
      --header 'Authorization: Bearer <personal-access-token>' \
      --header 'Content-Type: application/json' \
      --data '{"id":"DEVELOPER-ID"}'
   

   If you don’t remember the IDs for your test developers, you can send a GET request to list developers.
   
   You should get a 201 response like the following:

    Created
   

You now have added your test developer accounts to two teams with different access permissions for your Dev Portal. These developers won’t be able to access anything in Dev Portal yet, though, because we need to enable Portal RBAC next.

So far, you’ve used the following endpoints:

• Create team
• Assign role

1. From the navigation menu, open Dev Portal and click Settings in the sidebar.
2. To turn on Portal RBAC, click the Portal RBAC toggle.

Now, if you access your Dev Portal as one of the test developer accounts, you should see that the one assigned to the “Prospective Partners” team can only view the Pizza Ordering API while the one assigned to the “Authorized Delivery Partners” team can both view and consume the Pizza Ordering API.

To enable RBAC, you must make a PATCH request to the portal configuration endpoint. The following example shows how to enable RBAC in the portal. For more details on how to create your personal access token, see Authentication.

curl --request PATCH \
  --url https://{region}.api.konghq.com/konnect-api/api/portals/{portal-id} \
  --header 'Authorization: Bearer <personal-access-token>' \
  --header 'Content-Type: application/json' \
  --header 'accept: application/json' \
  --data '{"rbac_enabled": true}'

The portal-id can be found in the Konnect UI in the Dev Portal section.

Now, if you access your Dev Portal as one of the test developer accounts, you should see that the one assigned to the “Prospective Partners” team can only view the Pizza Ordering API while the one assigned to the “Authorized Delivery Partners” team can both view and consume the Pizza Ordering API.