Check if a scope has been granted

[Jericho]

Sometimes it would be useful to be able to check if a given scope has been granted before invoking a method to avoid getting an exception similar to: Invalid access token, does not contain scopes:[<...the name of the scope(s)...>].

What I envision is something along these lines:

if (zoomNetClient.HasPermission("account:read:list_sub_accounts:master"))
{
    var paginatedAccounts = await zoomNetClient.Accounts.GetAllAsync(100, null, cancellationToken).ConfigureAwait(false);
}

Also, I envision a similar method to check if multiple scopes have been granted like so:

if (zoomNetClient.HasPermissions(new[] { "scope1", "scope2", "scope3" }))
{
    ... do something that requires multiple scopes ...
}

[Jericho]

One thing to keep in mind: the .Scopes property on the OAuthConnectionInfo class gets populated when a token is refreshed. This means that his property is NOT populated if the developer specifies a previously issued token when instantiating the connection info like in this example:

var clientId = "... your client ID ...";
var clientSecret = "... your client secret ...";
var accountId = "... your account id ...";
var accessToken = Environment.GetEnvironmentVariable("ZOOM_OAUTH_SERVERTOSERVER_ACCESSTOKEN", EnvironmentVariableTarget.User);

var connectionInfo = OAuthConnectionInfo.ForServerToServer(clientId, clientSecret, accountId, accessToken,
  (_, newAccessToken) =>
  {
    Environment.SetEnvironmentVariable("ZOOM_OAUTH_SERVERTOSERVER_ACCESSTOKEN", newAccessToken, EnvironmentVariableTarget.User);
  });
var zoomClient = new ZoomClient(connectionInfo);

This means that there is a possibility for the .Scopes property to be empty when the HasPermissions method is invoked. In this scenario, the code in HasPermissions must detect if the list of scopes is empty and, if so, to populate the .Scopes before proceeding. Unfortunately, I am not aware of any way that we can retrieve the list of scopes that have been granted other than to force the current token to be refreshed.

[Jericho]

🎉 This issue has been resolved in version 0.84.0 🎉

The release is available on:

• GitHub Release
• NuGet Package

Your GitReleaseManager bot 📦🚀