Package dev.cerbos.sdk

Class CerbosBlockingClient

java.lang.Object

dev.cerbos.sdk.CerbosBlockingClient

public class CerbosBlockingClient
extends java.lang.Object

CerbosBlockingClient provides a client implementation that blocks waiting for a response from the PDP.

Method Summary

Modifier and Type	Method	Description
CheckResourcesRequestBuilder	batch(Principal principal)	Build a new batch request using the given principal.
CheckResourcesRequestBuilder	batch(Principal principal, AuxData auxData)	Build a new batch request using the given principal and auxData.
CheckResult	check(Principal principal, Resource resource, java.lang.String... actions)	Check whether the principal is allowed to perform the actions on the given resource.
CerbosBlockingClient	with(AuxData auxData)	Automatically attach the provided auxiliary data to requests.
CheckRequestBuilder	withPrincipal(Principal principal)	Deprecated. Use batch(Principal) instead

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

with

public CerbosBlockingClient with(AuxData auxData)

Automatically attach the provided auxiliary data to requests.

Parameters:

auxData - AuxData instance

Returns:

new CerbosBlockingClient configured to attach the auxiliary data to requests.

check

public CheckResult check(Principal principal,
                         Resource resource,
                         java.lang.String... actions)

Check whether the principal is allowed to perform the actions on the given resource.

Parameters:

principal - Principal performing the action

resource - Resource being accessed

actions - List of actions being performed on the resource

Returns:

Map keyed by action and a corresponding boolean to indicate whether it is allowed or not.

Throws:

CerbosException - if an RPC error occurs

batch

public CheckResourcesRequestBuilder batch(Principal principal)

Build a new batch request using the given principal.

Parameters:

principal - Principal performing the actions on resources.

Returns:

Instance of CheckResourcesRequestBuilder

batch

public CheckResourcesRequestBuilder batch(Principal principal,
                                          AuxData auxData)

Build a new batch request using the given principal and auxData.

Parameters:

principal - Principal performing the actions on resources.

auxData - AuxData instance

Returns:

Instance of CheckResourcesRequestBuilder

withPrincipal

public CheckRequestBuilder withPrincipal(Principal principal)

Deprecated.

Use batch(Principal) instead

Build a new batch request using the given principal.

Parameters:

principal - Principal performing the actions on resources.

Returns:

Instance of CheckRequestBuilder