Configure OAuth 2.0 scopes

On the OAuth scopes page, you can define scopes and assign them to resources and methods in your registered API. Scopes specify the extent to which client apps’ can use protected resources. You can assign a scope to the entire resource and all its associated methods and to each method individually. You must assign at least one scope to implement OAuth 2.0 in your system.

Note: This part of the OAuth 2.0 setup takes place in the API Definitions application.
Try the API: You can also complete this task by using the OAuth Management API. Run the Update an OAuth scope and Update OAuth scopes assignments operations. Learn more about Akamai’s APIs.

How to

Access the OAuth scopes configuration page

  1. On the API Definitions page, in the Registered APIs section, click the ellipsis icon () associated with the API configuration you want to configure scopes for.
  2. From the menu, select Manage versions.
  3. In the Version history panel, click the ellipsis icon () associated with the API configuration version you want to configure scopes for.
  4. From the list of delivery options, select OAuth scopes.
  5. On the OAuth scopes page, set the Enable OAuth scopes switch to Yes.

Define OAuth scopes

  1. Expand the Scope definitions section.
  2. In the Scope definitions section, click Create new scope.
  3. In the Create new scope window, in the Scope field, enter the name of the scope.
  4. Optional: In the Description field, enter a meaningful description of the scope.
    The description of a scope appears on the second consent page when resource owners grant client apps access to their data. Providing a meaningful description is important, because it ensures that a resource owner fully understands the extent to which a client app will be able to access their resources. For example, if you name a scope http://bookstore.api.com/users/id.read, you may add the following description to clarify the scope: “Allow the client app to view your user ID”.
  5. Click Save.

Assign OAuth scopes to resources and methods

  1. Expand the Scope assignments section.
  2. In the Scope column, for each resource and method that you want to make available to client apps, select at least one defined scope.
    A scope associated with a resource automatically applies to all methods within that resource. You can apply the same scope to more than one resource or method.

Next steps

Register a client app