({{, (RefLink[PermissionsKey, paclet:ref/PermissionsKey])["key"] 
represents a permissions key that can be used to authorize access to cloud resources.}})

OpenersNotesSection(Spacer1)Details

(RefLink[PermissionsKey, paclet:ref/PermissionsKey]) objects are created by assigning permissions with a (RefLink[PermissionsKey, paclet:ref/PermissionsKey]) to a cloud object.

In cloud access functions, (RefLink[Authentication, paclet:ref/Authentication])->PermissionsKey["key"] provides a permissions key credential.

In a web request, a query _key=key in the URL can be used to provide a permissions key credential.

(RefLink[DeleteObject, paclet:ref/DeleteObject])[PermissionsKey[…]] removes a (RefLink[PermissionsKey, paclet:ref/PermissionsKey]) object.

OpenersPrimaryExamplesSection(Spacer1)Examples  (2)

OpenersExampleSection0(Spacer1)Basic Examples  (1)

Create a cloud API with a permissions key:

obj= CloudDeploy[APIFunction[{"n"->Integer},#n^2&],Permissions->{PermissionsKey["thekey"]->"Execute"}]

Execute the API using the permissions key for authentication:

URLExecute[obj,{"n"->123},Authentication->PermissionsKey["thekey"]]

Execute the API explicitly giving the permissions key in the URL parameters:

URLExecute[obj, {"n"->123,"_key"->"thekey"}]

OpenersExampleSection1(Spacer1)Scope  (1)

Remove permissions keys from any cloud objects that are using them:

CloudDeploy[Delayed[RandomInteger[2^128]],Permissions->PermissionsKey["altkey"]->"Execute"]

DeleteObject[PermissionsKey["altkey"]]

Set a permissions key that is universally unique:

SetPermissions[CloudPut[42], PermissionsKey[CreateUUID[]] -> "Read"]

({{DocumentationFooterIconsRelatedFunction.png, ({{See Also}, {(RefLink[Permissions, paclet:ref/Permissions])  ▪  (RefLink[DeletePermissionsKey, paclet:ref/DeletePermissionsKey])  ▪  (RefLink[Authentication, paclet:ref/Authentication])  ▪  (RefLink[SecuredAuthenticationKey, paclet:ref/SecuredAuthenticationKey])  ▪  (RefLink[AuthenticationDialog, paclet:ref/AuthenticationDialog])}})}})

({{DocumentationFooterIconsRelatedGuide.png, ({{Related Guides}, {▪(RefLinkPlain[Cloud Permissions Control, paclet:guide/CloudPermissionsControl])}, {▪(RefLinkPlain[URL Manipulation, paclet:guide/URLManipulation])}, {▪(RefLinkPlain[HTTP Requests & Responses, paclet:guide/HTTPRequestsAndResponses])}, {▪(RefLinkPlain[Managing Content in the Cloud, paclet:guide/ManagingContentInTheCloud])}})}})