Registry / aws / aws-cryptography-internal-primitives

aws-cryptography-internal-primitives

JSON →
library1.11.2pypypiunverified

This library contains internal primitives used by higher-level AWS Cryptography libraries, such as the AWS Encryption SDK. It is *not intended for direct public consumption* and is explicitly marked for internal use only by AWS. Direct usage is strongly discouraged due to potential breaking changes without notice. The current version is 1.11.2, and it is actively maintained with irregular releases driven by upstream AWS Cryptography library requirements.

pip install aws-cryptography-internal-primitives
INSTALL
IMPORT
SIG · AWS-CRYPTOGRAPHY-I
A
aws-cryptography-internal-primitives
awspythonv1.11.2
Install
2.6s avg
Import
Disk
37MB
Pass rate
6/ 10
Env Coverage6 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v1.11.2 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
glibc
py 3.10
✕ build_error
✕ build_error
py 3.11
✓ —
✓ 2.75s
py 3.12
✓ —
✓ 2.45s
py 3.13
✓ —
✓ 2.5s
py 3.9
✕ build_error
✕ build_error
37MB installed
● package 37MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

SymmetricCryptoKey
from aws_cryptography_primitives.extern import SymmetricCryptoKey
from aws_cryptography_primitives.keys import SymmetricCryptoKey

This code demonstrates the creation of an internal `SymmetricCryptoKey` object for illustrative purposes only. *This library is strictly for internal AWS use* and not intended for direct customer consumption. Direct use of these primitives is strongly discouraged as the API is unstable, subject to breaking changes without notice, and does not offer the security and usability guarantees of higher-level AWS Cryptography SDKs (e.g., AWS Encryption SDK or AWS KMS Client). Do NOT use this code in production.

# WARNING: This library is for internal AWS use only and NOT intended for direct consumption. # The following code is for illustrative purposes only and should NOT be used in production. # Expect breaking changes without notice if you use this directly. import os from aws_cryptography_internal_primitives.keys import SymmetricCryptoKey, KeyType, KeyLength # This example demonstrates creating a SymmetricCryptoKey, an internal primitive. # Direct use is discouraged due to internal design and lack of stability guarantees. raw_aes_key = os.urandom(32) # 256-bit AES key # Create an internal symmetric key object internal_aes_key = SymmetricCryptoKey( material=raw_aes_key, key_type=KeyType.SYMMETRIC, key_length=KeyLength.AES_256 ) print(f"Internal Key Type: {internal_aes_key.key_type.name}") print(f"Internal Key Length: {internal_aes_key.key_length.value} bits") print(f"Key material is present: {internal_aes_key.material is not None}") # DO NOT print or expose raw key material in real applications!
Debug
Known issues
breakingThis library is not intended for direct use by customers. It is an internal dependency for higher-level AWS Cryptography libraries. Its public API is subject to breaking changes at any time without notice, even in minor versions.
fix
Use higher-level AWS Cryptography libraries like the AWS Encryption SDK or AWS KMS client instead of directly consuming this package.
affects: All versions
gotchaDirectly consuming this library bypasses the security, usability, and best practices features provided by higher-level AWS Cryptography SDKs, potentially leading to insecure implementations, complex key management issues, or non-compliance.
fix
Refer to official AWS Encryption SDK or AWS KMS client documentation for secure and supported cryptographic operations. Do not implement cryptographic primitives directly unless you are a security expert fully aware of the implications.
affects: All versions
breakingThe API surface of `aws-cryptography-internal-primitives` is unstable and has no versioning guarantees regarding public contracts. Upgrades to higher-level AWS Cryptography libraries might silently introduce breaking changes if you depend on this library directly.
fix
Avoid direct dependencies on this library; rely on stable, public AWS SDKs that manage these internal dependencies for you.
affects: All versions
Upgrade
Version history
1.11.2latest on PyPI · released Feb 23, 2026
Audit
Dependencies
cryptographyrequiredUnderlying cryptographic operations for key material handling and primitives.
Agent activity
57 hits · last 30 days
node
46
OpenAI (training)
1
Resources
aws-cryptography-internal-primitives — pip install aws-cryptography-internal-primitives · libregistry