Class OrchestrationKeyRequest
java.lang.Object
co.ankatech.keymanagement.client.keymanagement.model.OrchestrationKeyRequest
@Generated(value="org.openapitools.codegen.languages.JavaClientCodegen",
comments="Generator version: 7.23.0")
public class OrchestrationKeyRequest
extends Object
Request for key creation. Permission grants are issued separately.
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic classstatic enumKey derivation function combining the component secrets of a COMPOSITE_KEM_COMBINE key.static enumCryptographic purpose. -
Field Summary
Fields -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionaddKeyOpsItem(String keyOpsItem) booleanexportable(Boolean exportable) static OrchestrationKeyRequestCreate an instance of OrchestrationKeyRequest given an JSON stringCryptographic algorithmOptional expiration timestamp (ISO-8601 Instant).Whether the new key's public key may be exported (gates GET /keys/{kid}/export).getKdf()Key derivation function combining the component secrets of a COMPOSITE_KEM_COMBINE key.The wire value ofkdf: what the server sent, verbatim.Allowed key operationsgetKid()Human-readable key identifier (kid)getKty()Key type (kty).Hard usage cap; 0 or null = unlimited; must not be negative.Optional metadataCryptographic purpose.The wire value ofpurpose: what the server sent, verbatim.Optional soft/warning expiry timestamp (ISO-8601 Instant); must be before expiresAt, stated or defaulted (server-enforced, 400 otherwise).Soft usage warning threshold; must be less than maxUsageLimit (server-enforced); 0 or null = no soft threshold; must not be negative.inthashCode()maxUsageLimit(Integer maxUsageLimit) putMetadataItem(String key, Object metadataItem) voidsetAlgorithm(String algorithm) voidsetExpiresAt(String expiresAt) voidsetExportable(Boolean exportable) voidvoidvoidvoidvoidsetMaxUsageLimit(Integer maxUsageLimit) voidsetMetadata(Map<String, Object> metadata) voidvoidsetSoftLimitExpiration(String softLimitExpiration) voidsetSoftUsageLimit(Integer softUsageLimit) softLimitExpiration(String softLimitExpiration) softUsageLimit(Integer softUsageLimit) toJson()Convert an instance of OrchestrationKeyRequest to an JSON stringtoString()static voidvalidateJsonElement(com.google.gson.JsonElement jsonElement) Validates the JSON Element and throws an exception if issues foundstatic voidvalidateJsonElementAsCandidate(com.google.gson.JsonElement jsonElement) Validates the JSON Element as a candidate of a oneOf schema: the checks ofvalidateJsonElement(JsonElement), and the element carries no member this model does not declare.
-
Field Details
-
SERIALIZED_NAME_ALGORITHM
- See Also:
-
SERIALIZED_NAME_EXPIRES_AT
- See Also:
-
SERIALIZED_NAME_EXPORTABLE
- See Also:
-
SERIALIZED_NAME_KDF
- See Also:
-
SERIALIZED_NAME_KEY_OPS
- See Also:
-
SERIALIZED_NAME_KID
- See Also:
-
SERIALIZED_NAME_KTY
- See Also:
-
SERIALIZED_NAME_MAX_USAGE_LIMIT
- See Also:
-
SERIALIZED_NAME_METADATA
- See Also:
-
SERIALIZED_NAME_PURPOSE
- See Also:
-
SERIALIZED_NAME_SOFT_LIMIT_EXPIRATION
- See Also:
-
SERIALIZED_NAME_SOFT_USAGE_LIMIT
- See Also:
-
openapiFields
-
openapiRequiredFields
-
-
Constructor Details
-
OrchestrationKeyRequest
public OrchestrationKeyRequest()
-
-
Method Details
-
getKdfAsString
The wire value ofkdf: what the server sent, verbatim.- For a value this release declares, the same wire value the enum names.
- For a value it does not declare (one a later server added), the server's wire value verbatim,
while
getKdf()readsUNKNOWN_DEFAULT_OPEN_API; writing this model sends that wire value back, never the sentinel. - For an absent member,
null.
- Returns:
- the wire value, or
nullwhen the member is absent
-
getPurposeAsString
The wire value ofpurpose: what the server sent, verbatim.- For a value this release declares, the same wire value the enum names.
- For a value it does not declare (one a later server added), the server's wire value verbatim,
while
getPurpose()readsUNKNOWN_DEFAULT_OPEN_API; writing this model sends that wire value back, never the sentinel. - For an absent member,
null.
- Returns:
- the wire value, or
nullwhen the member is absent
-
algorithm
-
getAlgorithm
Cryptographic algorithm- Returns:
- algorithm
-
setAlgorithm
-
expiresAt
-
getExpiresAt
Optional expiration timestamp (ISO-8601 Instant). When omitted, the key expires at its creation time plus the maximum cryptoperiod of its key class (NIST SP 800-57 Part 1 Rev. 5, Table 1): 24 months for a symmetric or key-establishment key, 36 months for a signing key. Must be in the future when specified.- Returns:
- expiresAt
-
setExpiresAt
-
exportable
-
getExportable
Whether the new key's public key may be exported (gates GET /keys/{kid}/export). Optional; when omitted the backend default (false) applies.- Returns:
- exportable
-
setExportable
-
kdf
-
getKdf
Key derivation function combining the component secrets of a COMPOSITE_KEM_COMBINE key. Optional: when omitted, the cryptographic service applies the pairing's catalogue default. Ignored for simple keys and COMPOSITE_SIGNATURE. Membership is exact in case; an unpublished token is refused before any key material is provisioned.- Returns:
- kdf
-
setKdf
-
keyOps
-
addKeyOpsItem
-
getKeyOps
Allowed key operations- Returns:
- keyOps
-
setKeyOps
-
kid
-
getKid
Human-readable key identifier (kid)- Returns:
- kid
-
setKid
-
kty
-
getKty
Key type (kty). Must be a published key type; the set is closed and membership is exact in case. A composite key carries the coarse token COMPOSITE, never a construction name.- Returns:
- kty
-
setKty
-
maxUsageLimit
-
getMaxUsageLimit
Hard usage cap; 0 or null = unlimited; must not be negative. Optional; forwarded to the cryptographic service, which owns the default and enforcement. minimum: 0- Returns:
- maxUsageLimit
-
setMaxUsageLimit
-
metadata
-
putMetadataItem
-
getMetadata
Optional metadata- Returns:
- metadata
-
setMetadata
-
purpose
-
getPurpose
Cryptographic purpose. Optional — the cryptographic service derives it from the algorithm's key operations when unambiguous. REQUIRED for ambiguous algorithms whose key operations span both families (RSA, EC): supplying it narrows the operations sent to the cryptographic service to that purpose's family so the cryptographic service can resolve the purpose without returning 422 purpose-required. When omitted for an ambiguous algorithm, the cryptographic service 422 backstop applies.- Returns:
- purpose
-
setPurpose
-
softLimitExpiration
-
getSoftLimitExpiration
Optional soft/warning expiry timestamp (ISO-8601 Instant); must be before expiresAt, stated or defaulted (server-enforced, 400 otherwise). When omitted, two months before expiresAt and never before the creation time. Optional; forwarded raw to the cryptographic service, which owns the default and the ordering validation.- Returns:
- softLimitExpiration
-
setSoftLimitExpiration
-
softUsageLimit
-
getSoftUsageLimit
Soft usage warning threshold; must be less than maxUsageLimit (server-enforced); 0 or null = no soft threshold; must not be negative. Optional; forwarded to the cryptographic service, which owns the soft<max validation. minimum: 0- Returns:
- softUsageLimit
-
setSoftUsageLimit
-
equals
-
hashCode
public int hashCode() -
toString
-
validateJsonElement
Validates the JSON Element and throws an exception if issues found- Parameters:
jsonElement- JSON Element- Throws:
IOException- if the JSON Element is invalid with respect to OrchestrationKeyRequest
-
validateJsonElementAsCandidate
public static void validateJsonElementAsCandidate(com.google.gson.JsonElement jsonElement) throws IOException Validates the JSON Element as a candidate of a oneOf schema: the checks ofvalidateJsonElement(JsonElement), and the element carries no member this model does not declare. A oneOf schema without a discriminator tells its candidates apart by their member sets, so a candidate is matched on its closed member set.- Parameters:
jsonElement- JSON Element- Throws:
IOException- if the JSON Element is not a OrchestrationKeyRequest
-
fromJson
Create an instance of OrchestrationKeyRequest given an JSON string- Parameters:
jsonString- JSON string- Returns:
- An instance of OrchestrationKeyRequest
- Throws:
IOException- if the JSON string is invalid with respect to OrchestrationKeyRequest
-
toJson
Convert an instance of OrchestrationKeyRequest to an JSON string- Returns:
- JSON string
-