@ThreadSafe @Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AmazonVerifiedPermissionsAsyncClient extends AmazonVerifiedPermissionsClient implements AmazonVerifiedPermissionsAsync
AsyncHandler can be used to receive
notification when an asynchronous operation completes.
Amazon Verified Permissions is a permissions management service from Amazon Web Services. You can use Verified Permissions to manage permissions for your application, and authorize user access based on those permissions. Using Verified Permissions, application developers can grant access based on information about the users, resources, and requested actions. You can also evaluate additional information like group membership, attributes of the resources, and session context, such as time of request and IP addresses. Verified Permissions manages these permissions by letting you create and store authorization policies for your applications, such as consumer-facing web sites and enterprise business systems.
Verified Permissions uses Cedar as the policy language to express your permission requirements. Cedar supports both role-based access control (RBAC) and attribute-based access control (ABAC) authorization models.
For more information about configuring, administering, and using Amazon Verified Permissions in your applications, see the Amazon Verified Permissions User Guide.
For more information about the Cedar policy language, see the Cedar Policy Language Guide.
When you write Cedar policies that reference principals, resources and actions, you can define the unique identifiers used for each of those elements. We strongly recommend that you follow these best practices:
Use values like universally unique identifiers (UUIDs) for all principal and resource identifiers.
For example, if user jane leaves the company, and you later let someone else use the name
jane, then that new user automatically gets access to everything granted by policies that still
reference User::"jane". Cedar can’t distinguish between the new user and the old. This applies to both
principal and resource identifiers. Always use identifiers that are guaranteed unique and never reused to ensure that
you don’t unintentionally grant access because of the presence of an old identifier in a policy.
Where you use a UUID for an entity, we recommend that you follow it with the // comment specifier and the ‘friendly’ name of your entity. This helps to make your policies easier to understand. For example: principal == User::"a1b2c3d4-e5f6-a1b2-c3d4-EXAMPLE11111", // alice
Do not include personally identifying, confidential, or sensitive information as part of the unique identifier for your principals or resources. These identifiers are included in log entries shared in CloudTrail trails.
Several operations return structures that appear similar, but have different purposes. As new functionality is added to the product, the structure used in a parameter of one operation might need to change in a way that wouldn't make sense for the same parameter in a different operation. To help you understand the purpose of each, the following naming convention is used for the structures:
Parameter type structures that end in Detail are used in Get operations.
Parameter type structures that end in Item are used in List operations.
Parameter type structures that use neither suffix are used in the mutating (create and update) operations.
LOGGING_AWS_REQUEST_METRICENDPOINT_PREFIXbuilder, createIdentitySource, createPolicy, createPolicyStore, createPolicyTemplate, deleteIdentitySource, deletePolicy, deletePolicyStore, deletePolicyTemplate, getCachedResponseMetadata, getIdentitySource, getPolicy, getPolicyStore, getPolicyTemplate, getSchema, isAuthorized, isAuthorizedWithToken, listIdentitySources, listPolicies, listPolicyStores, listPolicyTemplates, putSchema, updateIdentitySource, updatePolicy, updatePolicyStore, updatePolicyTemplateaddRequestHandler, addRequestHandler, configureRegion, getClientConfiguration, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, withEndpoint, withRegion, withRegion, withTimeOffsetequals, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitcreateIdentitySource, createPolicy, createPolicyStore, createPolicyTemplate, deleteIdentitySource, deletePolicy, deletePolicyStore, deletePolicyTemplate, getCachedResponseMetadata, getIdentitySource, getPolicy, getPolicyStore, getPolicyTemplate, getSchema, isAuthorized, isAuthorizedWithToken, listIdentitySources, listPolicies, listPolicyStores, listPolicyTemplates, putSchema, updateIdentitySource, updatePolicy, updatePolicyStore, updatePolicyTemplatepublic static AmazonVerifiedPermissionsAsyncClientBuilder asyncBuilder()
public ExecutorService getExecutorService()
public Future<CreateIdentitySourceResult> createIdentitySourceAsync(CreateIdentitySourceRequest request)
AmazonVerifiedPermissionsAsyncCreates a reference to an Amazon Cognito user pool as an external identity provider (IdP).
After you create an identity source, you can use the identities provided by the IdP as proxies for the principal in authorization queries that use the IsAuthorizedWithToken operation. These identities take the form of tokens that contain claims about the user, such as IDs, attributes and group memberships. Amazon Cognito provides both identity tokens and access tokens, and Verified Permissions can use either or both. Any combination of identity and access tokens results in the same Cedar principal. Verified Permissions automatically translates the information about the identities into the standard Cedar attributes that can be evaluated by your policies. Because the Amazon Cognito identity and access tokens can contain different information, the tokens you choose to use determine which principal attributes are available to access when evaluating Cedar policies.
If you delete a Amazon Cognito user pool or user, tokens from that deleted pool or that deleted user continue to be usable until they expire.
To reference a user from this identity source in your Cedar policies, use the following syntax.
IdentityType::"<CognitoUserPoolIdentifier>|<CognitoClientId>
Where IdentityType is the string that you provide to the PrincipalEntityType parameter
for this operation. The CognitoUserPoolId and CognitoClientId are defined by the Amazon
Cognito user pool.
createIdentitySourceAsync in interface AmazonVerifiedPermissionsAsyncpublic Future<CreateIdentitySourceResult> createIdentitySourceAsync(CreateIdentitySourceRequest request, AsyncHandler<CreateIdentitySourceRequest,CreateIdentitySourceResult> asyncHandler)
AmazonVerifiedPermissionsAsyncCreates a reference to an Amazon Cognito user pool as an external identity provider (IdP).
After you create an identity source, you can use the identities provided by the IdP as proxies for the principal in authorization queries that use the IsAuthorizedWithToken operation. These identities take the form of tokens that contain claims about the user, such as IDs, attributes and group memberships. Amazon Cognito provides both identity tokens and access tokens, and Verified Permissions can use either or both. Any combination of identity and access tokens results in the same Cedar principal. Verified Permissions automatically translates the information about the identities into the standard Cedar attributes that can be evaluated by your policies. Because the Amazon Cognito identity and access tokens can contain different information, the tokens you choose to use determine which principal attributes are available to access when evaluating Cedar policies.
If you delete a Amazon Cognito user pool or user, tokens from that deleted pool or that deleted user continue to be usable until they expire.
To reference a user from this identity source in your Cedar policies, use the following syntax.
IdentityType::"<CognitoUserPoolIdentifier>|<CognitoClientId>
Where IdentityType is the string that you provide to the PrincipalEntityType parameter
for this operation. The CognitoUserPoolId and CognitoClientId are defined by the Amazon
Cognito user pool.
createIdentitySourceAsync in interface AmazonVerifiedPermissionsAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<CreatePolicyResult> createPolicyAsync(CreatePolicyRequest request)
AmazonVerifiedPermissionsAsyncCreates a Cedar policy and saves it in the specified policy store. You can create either a static policy or a policy linked to a policy template.
To create a static policy, provide the Cedar policy text in the StaticPolicy section of the
PolicyDefinition.
To create a policy that is dynamically linked to a policy template, specify the policy template ID and the
principal and resource to associate with this policy in the templateLinked section of the
PolicyDefinition. If the policy template is ever updated, any policies linked to the policy template
automatically use the updated template.
Creating a policy causes it to be validated against the schema in the policy store. If the policy doesn't pass validation, the operation fails and the policy isn't stored.
createPolicyAsync in interface AmazonVerifiedPermissionsAsyncpublic Future<CreatePolicyResult> createPolicyAsync(CreatePolicyRequest request, AsyncHandler<CreatePolicyRequest,CreatePolicyResult> asyncHandler)
AmazonVerifiedPermissionsAsyncCreates a Cedar policy and saves it in the specified policy store. You can create either a static policy or a policy linked to a policy template.
To create a static policy, provide the Cedar policy text in the StaticPolicy section of the
PolicyDefinition.
To create a policy that is dynamically linked to a policy template, specify the policy template ID and the
principal and resource to associate with this policy in the templateLinked section of the
PolicyDefinition. If the policy template is ever updated, any policies linked to the policy template
automatically use the updated template.
Creating a policy causes it to be validated against the schema in the policy store. If the policy doesn't pass validation, the operation fails and the policy isn't stored.
createPolicyAsync in interface AmazonVerifiedPermissionsAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<CreatePolicyStoreResult> createPolicyStoreAsync(CreatePolicyStoreRequest request)
AmazonVerifiedPermissionsAsyncCreates a policy store. A policy store is a container for policy resources.
Although Cedar supports multiple namespaces, Verified Permissions currently supports only one namespace per policy store.
createPolicyStoreAsync in interface AmazonVerifiedPermissionsAsyncpublic Future<CreatePolicyStoreResult> createPolicyStoreAsync(CreatePolicyStoreRequest request, AsyncHandler<CreatePolicyStoreRequest,CreatePolicyStoreResult> asyncHandler)
AmazonVerifiedPermissionsAsyncCreates a policy store. A policy store is a container for policy resources.
Although Cedar supports multiple namespaces, Verified Permissions currently supports only one namespace per policy store.
createPolicyStoreAsync in interface AmazonVerifiedPermissionsAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<CreatePolicyTemplateResult> createPolicyTemplateAsync(CreatePolicyTemplateRequest request)
AmazonVerifiedPermissionsAsyncCreates a policy template. A template can use placeholders for the principal and resource. A template must be instantiated into a policy by associating it with specific principals and resources to use for the placeholders. That instantiated policy can then be considered in authorization decisions. The instantiated policy works identically to any other policy, except that it is dynamically linked to the template. If the template changes, then any policies that are linked to that template are immediately updated as well.
createPolicyTemplateAsync in interface AmazonVerifiedPermissionsAsyncpublic Future<CreatePolicyTemplateResult> createPolicyTemplateAsync(CreatePolicyTemplateRequest request, AsyncHandler<CreatePolicyTemplateRequest,CreatePolicyTemplateResult> asyncHandler)
AmazonVerifiedPermissionsAsyncCreates a policy template. A template can use placeholders for the principal and resource. A template must be instantiated into a policy by associating it with specific principals and resources to use for the placeholders. That instantiated policy can then be considered in authorization decisions. The instantiated policy works identically to any other policy, except that it is dynamically linked to the template. If the template changes, then any policies that are linked to that template are immediately updated as well.
createPolicyTemplateAsync in interface AmazonVerifiedPermissionsAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<DeleteIdentitySourceResult> deleteIdentitySourceAsync(DeleteIdentitySourceRequest request)
AmazonVerifiedPermissionsAsyncDeletes an identity source that references an identity provider (IdP) such as Amazon Cognito. After you delete the identity source, you can no longer use tokens for identities from that identity source to represent principals in authorization queries made using IsAuthorizedWithToken. operations.
deleteIdentitySourceAsync in interface AmazonVerifiedPermissionsAsyncpublic Future<DeleteIdentitySourceResult> deleteIdentitySourceAsync(DeleteIdentitySourceRequest request, AsyncHandler<DeleteIdentitySourceRequest,DeleteIdentitySourceResult> asyncHandler)
AmazonVerifiedPermissionsAsyncDeletes an identity source that references an identity provider (IdP) such as Amazon Cognito. After you delete the identity source, you can no longer use tokens for identities from that identity source to represent principals in authorization queries made using IsAuthorizedWithToken. operations.
deleteIdentitySourceAsync in interface AmazonVerifiedPermissionsAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<DeletePolicyResult> deletePolicyAsync(DeletePolicyRequest request)
AmazonVerifiedPermissionsAsyncDeletes the specified policy from the policy store.
This operation is idempotent; if you specify a policy that doesn't exist, the request response returns a
successful HTTP 200 status code.
deletePolicyAsync in interface AmazonVerifiedPermissionsAsyncpublic Future<DeletePolicyResult> deletePolicyAsync(DeletePolicyRequest request, AsyncHandler<DeletePolicyRequest,DeletePolicyResult> asyncHandler)
AmazonVerifiedPermissionsAsyncDeletes the specified policy from the policy store.
This operation is idempotent; if you specify a policy that doesn't exist, the request response returns a
successful HTTP 200 status code.
deletePolicyAsync in interface AmazonVerifiedPermissionsAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<DeletePolicyStoreResult> deletePolicyStoreAsync(DeletePolicyStoreRequest request)
AmazonVerifiedPermissionsAsyncDeletes the specified policy store.
This operation is idempotent. If you specify a policy store that does not exist, the request response will still return a successful HTTP 200 status code.
deletePolicyStoreAsync in interface AmazonVerifiedPermissionsAsyncpublic Future<DeletePolicyStoreResult> deletePolicyStoreAsync(DeletePolicyStoreRequest request, AsyncHandler<DeletePolicyStoreRequest,DeletePolicyStoreResult> asyncHandler)
AmazonVerifiedPermissionsAsyncDeletes the specified policy store.
This operation is idempotent. If you specify a policy store that does not exist, the request response will still return a successful HTTP 200 status code.
deletePolicyStoreAsync in interface AmazonVerifiedPermissionsAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<DeletePolicyTemplateResult> deletePolicyTemplateAsync(DeletePolicyTemplateRequest request)
AmazonVerifiedPermissionsAsyncDeletes the specified policy template from the policy store.
This operation also deletes any policies that were created from the specified policy template. Those policies are immediately removed from all future API responses, and are asynchronously deleted from the policy store.
deletePolicyTemplateAsync in interface AmazonVerifiedPermissionsAsyncpublic Future<DeletePolicyTemplateResult> deletePolicyTemplateAsync(DeletePolicyTemplateRequest request, AsyncHandler<DeletePolicyTemplateRequest,DeletePolicyTemplateResult> asyncHandler)
AmazonVerifiedPermissionsAsyncDeletes the specified policy template from the policy store.
This operation also deletes any policies that were created from the specified policy template. Those policies are immediately removed from all future API responses, and are asynchronously deleted from the policy store.
deletePolicyTemplateAsync in interface AmazonVerifiedPermissionsAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<GetIdentitySourceResult> getIdentitySourceAsync(GetIdentitySourceRequest request)
AmazonVerifiedPermissionsAsyncRetrieves the details about the specified identity source.
getIdentitySourceAsync in interface AmazonVerifiedPermissionsAsyncpublic Future<GetIdentitySourceResult> getIdentitySourceAsync(GetIdentitySourceRequest request, AsyncHandler<GetIdentitySourceRequest,GetIdentitySourceResult> asyncHandler)
AmazonVerifiedPermissionsAsyncRetrieves the details about the specified identity source.
getIdentitySourceAsync in interface AmazonVerifiedPermissionsAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<GetPolicyResult> getPolicyAsync(GetPolicyRequest request)
AmazonVerifiedPermissionsAsyncRetrieves information about the specified policy.
getPolicyAsync in interface AmazonVerifiedPermissionsAsyncpublic Future<GetPolicyResult> getPolicyAsync(GetPolicyRequest request, AsyncHandler<GetPolicyRequest,GetPolicyResult> asyncHandler)
AmazonVerifiedPermissionsAsyncRetrieves information about the specified policy.
getPolicyAsync in interface AmazonVerifiedPermissionsAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<GetPolicyStoreResult> getPolicyStoreAsync(GetPolicyStoreRequest request)
AmazonVerifiedPermissionsAsyncRetrieves details about a policy store.
getPolicyStoreAsync in interface AmazonVerifiedPermissionsAsyncpublic Future<GetPolicyStoreResult> getPolicyStoreAsync(GetPolicyStoreRequest request, AsyncHandler<GetPolicyStoreRequest,GetPolicyStoreResult> asyncHandler)
AmazonVerifiedPermissionsAsyncRetrieves details about a policy store.
getPolicyStoreAsync in interface AmazonVerifiedPermissionsAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<GetPolicyTemplateResult> getPolicyTemplateAsync(GetPolicyTemplateRequest request)
AmazonVerifiedPermissionsAsyncRetrieve the details for the specified policy template in the specified policy store.
getPolicyTemplateAsync in interface AmazonVerifiedPermissionsAsyncpublic Future<GetPolicyTemplateResult> getPolicyTemplateAsync(GetPolicyTemplateRequest request, AsyncHandler<GetPolicyTemplateRequest,GetPolicyTemplateResult> asyncHandler)
AmazonVerifiedPermissionsAsyncRetrieve the details for the specified policy template in the specified policy store.
getPolicyTemplateAsync in interface AmazonVerifiedPermissionsAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<GetSchemaResult> getSchemaAsync(GetSchemaRequest request)
AmazonVerifiedPermissionsAsyncRetrieve the details for the specified schema in the specified policy store.
getSchemaAsync in interface AmazonVerifiedPermissionsAsyncpublic Future<GetSchemaResult> getSchemaAsync(GetSchemaRequest request, AsyncHandler<GetSchemaRequest,GetSchemaResult> asyncHandler)
AmazonVerifiedPermissionsAsyncRetrieve the details for the specified schema in the specified policy store.
getSchemaAsync in interface AmazonVerifiedPermissionsAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<IsAuthorizedResult> isAuthorizedAsync(IsAuthorizedRequest request)
AmazonVerifiedPermissionsAsync
Makes an authorization decision about a service request described in the parameters. The information in the
parameters can also define additional context that Verified Permissions can include in the evaluation. The
request is evaluated against all matching policies in the specified policy store. The result of the decision is
either Allow or Deny, along with a list of the policies that resulted in the decision.
isAuthorizedAsync in interface AmazonVerifiedPermissionsAsyncpublic Future<IsAuthorizedResult> isAuthorizedAsync(IsAuthorizedRequest request, AsyncHandler<IsAuthorizedRequest,IsAuthorizedResult> asyncHandler)
AmazonVerifiedPermissionsAsync
Makes an authorization decision about a service request described in the parameters. The information in the
parameters can also define additional context that Verified Permissions can include in the evaluation. The
request is evaluated against all matching policies in the specified policy store. The result of the decision is
either Allow or Deny, along with a list of the policies that resulted in the decision.
isAuthorizedAsync in interface AmazonVerifiedPermissionsAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<IsAuthorizedWithTokenResult> isAuthorizedWithTokenAsync(IsAuthorizedWithTokenRequest request)
AmazonVerifiedPermissionsAsync
Makes an authorization decision about a service request described in the parameters. The principal in this
request comes from an external identity source in the form of an identity token formatted as a JSON web token (JWT). The information in the parameters can
also define additional context that Verified Permissions can include in the evaluation. The request is evaluated
against all matching policies in the specified policy store. The result of the decision is either
Allow or Deny, along with a list of the policies that resulted in the decision.
If you specify the identityToken parameter, then this operation derives the principal from that
token. You must not also include that principal in the entities parameter or the operation fails and
reports a conflict between the two entity sources.
If you provide only an accessToken, then you can include the entity as part of the
entities parameter to provide additional attributes.
At this time, Verified Permissions accepts tokens from only Amazon Cognito.
Verified Permissions validates each token that is specified in a request by checking its expiration date and its signature.
If you delete a Amazon Cognito user pool or user, tokens from that deleted pool or that deleted user continue to be usable until they expire.
isAuthorizedWithTokenAsync in interface AmazonVerifiedPermissionsAsyncpublic Future<IsAuthorizedWithTokenResult> isAuthorizedWithTokenAsync(IsAuthorizedWithTokenRequest request, AsyncHandler<IsAuthorizedWithTokenRequest,IsAuthorizedWithTokenResult> asyncHandler)
AmazonVerifiedPermissionsAsync
Makes an authorization decision about a service request described in the parameters. The principal in this
request comes from an external identity source in the form of an identity token formatted as a JSON web token (JWT). The information in the parameters can
also define additional context that Verified Permissions can include in the evaluation. The request is evaluated
against all matching policies in the specified policy store. The result of the decision is either
Allow or Deny, along with a list of the policies that resulted in the decision.
If you specify the identityToken parameter, then this operation derives the principal from that
token. You must not also include that principal in the entities parameter or the operation fails and
reports a conflict between the two entity sources.
If you provide only an accessToken, then you can include the entity as part of the
entities parameter to provide additional attributes.
At this time, Verified Permissions accepts tokens from only Amazon Cognito.
Verified Permissions validates each token that is specified in a request by checking its expiration date and its signature.
If you delete a Amazon Cognito user pool or user, tokens from that deleted pool or that deleted user continue to be usable until they expire.
isAuthorizedWithTokenAsync in interface AmazonVerifiedPermissionsAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<ListIdentitySourcesResult> listIdentitySourcesAsync(ListIdentitySourcesRequest request)
AmazonVerifiedPermissionsAsyncReturns a paginated list of all of the identity sources defined in the specified policy store.
listIdentitySourcesAsync in interface AmazonVerifiedPermissionsAsyncpublic Future<ListIdentitySourcesResult> listIdentitySourcesAsync(ListIdentitySourcesRequest request, AsyncHandler<ListIdentitySourcesRequest,ListIdentitySourcesResult> asyncHandler)
AmazonVerifiedPermissionsAsyncReturns a paginated list of all of the identity sources defined in the specified policy store.
listIdentitySourcesAsync in interface AmazonVerifiedPermissionsAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<ListPoliciesResult> listPoliciesAsync(ListPoliciesRequest request)
AmazonVerifiedPermissionsAsyncReturns a paginated list of all policies stored in the specified policy store.
listPoliciesAsync in interface AmazonVerifiedPermissionsAsyncpublic Future<ListPoliciesResult> listPoliciesAsync(ListPoliciesRequest request, AsyncHandler<ListPoliciesRequest,ListPoliciesResult> asyncHandler)
AmazonVerifiedPermissionsAsyncReturns a paginated list of all policies stored in the specified policy store.
listPoliciesAsync in interface AmazonVerifiedPermissionsAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<ListPolicyStoresResult> listPolicyStoresAsync(ListPolicyStoresRequest request)
AmazonVerifiedPermissionsAsyncReturns a paginated list of all policy stores in the calling Amazon Web Services account.
listPolicyStoresAsync in interface AmazonVerifiedPermissionsAsyncpublic Future<ListPolicyStoresResult> listPolicyStoresAsync(ListPolicyStoresRequest request, AsyncHandler<ListPolicyStoresRequest,ListPolicyStoresResult> asyncHandler)
AmazonVerifiedPermissionsAsyncReturns a paginated list of all policy stores in the calling Amazon Web Services account.
listPolicyStoresAsync in interface AmazonVerifiedPermissionsAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<ListPolicyTemplatesResult> listPolicyTemplatesAsync(ListPolicyTemplatesRequest request)
AmazonVerifiedPermissionsAsyncReturns a paginated list of all policy templates in the specified policy store.
listPolicyTemplatesAsync in interface AmazonVerifiedPermissionsAsyncpublic Future<ListPolicyTemplatesResult> listPolicyTemplatesAsync(ListPolicyTemplatesRequest request, AsyncHandler<ListPolicyTemplatesRequest,ListPolicyTemplatesResult> asyncHandler)
AmazonVerifiedPermissionsAsyncReturns a paginated list of all policy templates in the specified policy store.
listPolicyTemplatesAsync in interface AmazonVerifiedPermissionsAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<PutSchemaResult> putSchemaAsync(PutSchemaRequest request)
AmazonVerifiedPermissionsAsyncCreates or updates the policy schema in the specified policy store. The schema is used to validate any Cedar policies and policy templates submitted to the policy store. Any changes to the schema validate only policies and templates submitted after the schema change. Existing policies and templates are not re-evaluated against the changed schema. If you later update a policy, then it is evaluated against the new schema at that time.
putSchemaAsync in interface AmazonVerifiedPermissionsAsyncpublic Future<PutSchemaResult> putSchemaAsync(PutSchemaRequest request, AsyncHandler<PutSchemaRequest,PutSchemaResult> asyncHandler)
AmazonVerifiedPermissionsAsyncCreates or updates the policy schema in the specified policy store. The schema is used to validate any Cedar policies and policy templates submitted to the policy store. Any changes to the schema validate only policies and templates submitted after the schema change. Existing policies and templates are not re-evaluated against the changed schema. If you later update a policy, then it is evaluated against the new schema at that time.
putSchemaAsync in interface AmazonVerifiedPermissionsAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<UpdateIdentitySourceResult> updateIdentitySourceAsync(UpdateIdentitySourceRequest request)
AmazonVerifiedPermissionsAsyncUpdates the specified identity source to use a new identity provider (IdP) source, or to change the mapping of identities from the IdP to a different principal entity type.
updateIdentitySourceAsync in interface AmazonVerifiedPermissionsAsyncpublic Future<UpdateIdentitySourceResult> updateIdentitySourceAsync(UpdateIdentitySourceRequest request, AsyncHandler<UpdateIdentitySourceRequest,UpdateIdentitySourceResult> asyncHandler)
AmazonVerifiedPermissionsAsyncUpdates the specified identity source to use a new identity provider (IdP) source, or to change the mapping of identities from the IdP to a different principal entity type.
updateIdentitySourceAsync in interface AmazonVerifiedPermissionsAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<UpdatePolicyResult> updatePolicyAsync(UpdatePolicyRequest request)
AmazonVerifiedPermissionsAsyncModifies a Cedar static policy in the specified policy store. You can change only certain elements of the UpdatePolicyDefinition parameter. You can directly update only static policies. To change a template-linked policy, you must update the template instead, using UpdatePolicyTemplate.
If policy validation is enabled in the policy store, then updating a static policy causes Verified Permissions to validate the policy against the schema in the policy store. If the updated static policy doesn't pass validation, the operation fails and the update isn't stored.
When you edit a static policy, You can change only certain elements of a static policy:
The action referenced by the policy.
A condition clause, such as when and unless.
You can't change these elements of a static policy:
Changing a policy from a static policy to a template-linked policy.
Changing the effect of a static policy from permit or forbid.
The principal referenced by a static policy.
The resource referenced by a static policy.
To update a template-linked policy, you must update the template instead.
updatePolicyAsync in interface AmazonVerifiedPermissionsAsyncpublic Future<UpdatePolicyResult> updatePolicyAsync(UpdatePolicyRequest request, AsyncHandler<UpdatePolicyRequest,UpdatePolicyResult> asyncHandler)
AmazonVerifiedPermissionsAsyncModifies a Cedar static policy in the specified policy store. You can change only certain elements of the UpdatePolicyDefinition parameter. You can directly update only static policies. To change a template-linked policy, you must update the template instead, using UpdatePolicyTemplate.
If policy validation is enabled in the policy store, then updating a static policy causes Verified Permissions to validate the policy against the schema in the policy store. If the updated static policy doesn't pass validation, the operation fails and the update isn't stored.
When you edit a static policy, You can change only certain elements of a static policy:
The action referenced by the policy.
A condition clause, such as when and unless.
You can't change these elements of a static policy:
Changing a policy from a static policy to a template-linked policy.
Changing the effect of a static policy from permit or forbid.
The principal referenced by a static policy.
The resource referenced by a static policy.
To update a template-linked policy, you must update the template instead.
updatePolicyAsync in interface AmazonVerifiedPermissionsAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<UpdatePolicyStoreResult> updatePolicyStoreAsync(UpdatePolicyStoreRequest request)
AmazonVerifiedPermissionsAsyncModifies the validation setting for a policy store.
updatePolicyStoreAsync in interface AmazonVerifiedPermissionsAsyncpublic Future<UpdatePolicyStoreResult> updatePolicyStoreAsync(UpdatePolicyStoreRequest request, AsyncHandler<UpdatePolicyStoreRequest,UpdatePolicyStoreResult> asyncHandler)
AmazonVerifiedPermissionsAsyncModifies the validation setting for a policy store.
updatePolicyStoreAsync in interface AmazonVerifiedPermissionsAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<UpdatePolicyTemplateResult> updatePolicyTemplateAsync(UpdatePolicyTemplateRequest request)
AmazonVerifiedPermissionsAsyncUpdates the specified policy template. You can update only the description and the some elements of the policyBody.
Changes you make to the policy template content are immediately reflected in authorization decisions that involve all template-linked policies instantiated from this template.
updatePolicyTemplateAsync in interface AmazonVerifiedPermissionsAsyncpublic Future<UpdatePolicyTemplateResult> updatePolicyTemplateAsync(UpdatePolicyTemplateRequest request, AsyncHandler<UpdatePolicyTemplateRequest,UpdatePolicyTemplateResult> asyncHandler)
AmazonVerifiedPermissionsAsyncUpdates the specified policy template. You can update only the description and the some elements of the policyBody.
Changes you make to the policy template content are immediately reflected in authorization decisions that involve all template-linked policies instantiated from this template.
updatePolicyTemplateAsync in interface AmazonVerifiedPermissionsAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public void shutdown()
getExecutorService().shutdown() followed by getExecutorService().awaitTermination() prior to
calling this method.shutdown in interface AmazonVerifiedPermissionsshutdown in class AmazonVerifiedPermissionsClient