Class McpAdmissionIdentity

java.lang.Object

com.soklet.McpAdmissionIdentity

@ThreadSafe
public final class McpAdmissionIdentity
extends Object

Shallowly immutable application-supplied identity and stable, opaque partition keys. The carrier itself is safe for concurrent access; applications retain responsibility for the thread-safety of principal and application-context objects they place inside it.

Instances intentionally retain reference identity. Principal and application-context objects are opaque security capabilities and do not participate in framework-defined structural equality. Authorization code must compare the documented stable partition keys or apply its own principal policy explicitly.

Author:

Mark Allen

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	McpAdmissionIdentity.Builder	Mutable builder for an immutable McpAdmissionIdentity.

Field Summary

Fields

Modifier and Type	Field	Description
static final @NonNull Integer	MAXIMUM_PARTITION_KEY_SIZE_IN_UTF_8_BYTES	Maximum UTF-8 encoding length of either partition key.

Method Summary

Modifier and Type	Method	Description
static @NonNull McpAdmissionIdentity	anonymousInstance()	Returns the canonical anonymous identity.
@NonNull Optional<@NonNull Object>	getApplicationContext()
@NonNull Optional<@NonNull String>	getAuthorizationPartitionKey()	Returns the opaque authorization partition key.
@NonNull Optional<@NonNull Object>	getPrincipal()
@NonNull String	getRateLimitPartitionKey()
@NonNull Boolean	isAuthenticated()
static @NonNull McpAdmissionIdentity.Builder	withRateLimitPartitionKey(@NonNull String rateLimitPartitionKey)	Vends an identity builder primed with a stable rate-limit partition key.

Methods inherited from class Object

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

Field Details

MAXIMUM_PARTITION_KEY_SIZE_IN_UTF_8_BYTES

public static final @NonNull Integer MAXIMUM_PARTITION_KEY_SIZE_IN_UTF_8_BYTES

Maximum UTF-8 encoding length of either partition key.

Method Details

anonymousInstance

public static @NonNull McpAdmissionIdentity anonymousInstance()

Returns the canonical anonymous identity.

Returns:

shared anonymous identity

withRateLimitPartitionKey

public static @NonNull McpAdmissionIdentity.Builder withRateLimitPartitionKey(@NonNull String rateLimitPartitionKey)

Vends an identity builder primed with a stable rate-limit partition key.

Parameters:

rateLimitPartitionKey - opaque, fleet-stable partition key

Returns:

identity builder

isAuthenticated

public @NonNull Boolean isAuthenticated()

Returns:

whether a principal is present

getPrincipal

public @NonNull Optional<@NonNull Object> getPrincipal()

Returns:

application principal, when authenticated

getApplicationContext

public @NonNull Optional<@NonNull Object> getApplicationContext()

Returns:

optional application context propagated to later MCP hooks

getRateLimitPartitionKey

public @NonNull String getRateLimitPartitionKey()

Returns:

opaque rate-limit partition key

getAuthorizationPartitionKey

public @NonNull Optional<@NonNull String> getAuthorizationPartitionKey()

Returns the opaque authorization partition key. Absence selects Soklet's endpoint-scoped anonymous authorization partition.

Returns:

authorization partition key, when supplied