Web Cryptography API의 현대 알고리즘

이 명세는 [webcrypto]의 KeyFormat 정의를 다음으로 대체한다.

WebIDLenum KeyFormat { "raw-public", "raw-private", "raw-seed", "raw-secret", "raw", "spki", "pkcs8", "jwk" };

이 명세는 여러 새로운 인식되는 키 형식 값을 명시한다.

raw-public

형식이 지정되지 않은 공개 키 바이트 시퀀스.

raw-private

형식이 지정되지 않은 비밀 키 바이트 시퀀스.

raw-seed

형식이 지정되지 않은 비밀 키 시드 바이트 시퀀스.

raw-secret

형식이 지정되지 않은 비밀 키 바이트 시퀀스.

[webcrypto]의 기존 모든 대칭 알고리즘에서 "raw-secret"은 "raw"의 별칭으로 동작한다.

[webcrypto]의 기존 모든 비대칭 알고리즘에서 "raw-public"은 "raw"의 별칭으로 동작한다.

deriveKey() 메서드의 키 가져오기 단계에서는 "raw" 대신 "raw-secret"을 형식으로 사용해야 한다.

이 명세는 [webcrypto]의 KeyUsage 정의를 다음으로 대체한다.

WebIDLenum KeyUsage { "encrypt", "decrypt", "sign", "verify", "deriveKey", "deriveBits", "wrapKey", "unwrapKey", "encapsulateKey", "encapsulateBits", "decapsulateKey", "decapsulateBits" };

이 명세는 여러 새로운 인식되는 키 용도 값을 명시한다.

encapsulateKey

SubtleCrypto.encapsulateKey에서 키를 사용할 수 있도록 한다.

encapsulateBits

SubtleCrypto.encapsulateBits에서 키를 사용할 수 있도록 한다.

decapsulateKey

SubtleCrypto.decapsulateKey에서 키를 사용할 수 있도록 한다.

decapsulateBits

SubtleCrypto.decapsulateBits에서 키를 사용할 수 있도록 한다.

encapsulateKey(encapsulationAlgorithm, encapsulationKey, sharedKeyAlgorithm, extractable, usages) 메서드는 키를 캡슐화하고 EncapsulatedKey 객체를 반환한다. 다음과 같이 동작한다.

1. encapsulationAlgorithm, encapsulationKey, sharedKeyAlgorithm, extractable 및 usages를 각각 encapsulateKey() 메서드에 전달된 encapsulationAlgorithm, encapsulationKey, sharedKeyAlgorithm, extractable 및 keyUsages 매개변수로 둔다.

2. alg를 encapsulationAlgorithm로 설정하고 op를 "encapsulate"로 설정하여 알고리즘을 정규화한 결과를 normalizedEncapsulationAlgorithm로 둔다.

3. 오류가 발생한 경우 normalizedEncapsulationAlgorithm로 거부된 Promise를 반환한다.

4. alg를 sharedKeyAlgorithm로 설정하고 op를 "importKey"로 설정하여 알고리즘을 정규화한 결과를 normalizedSharedKeyAlgorithm로 둔다.

5. 오류가 발생한 경우 normalizedSharedKeyAlgorithm로 거부된 Promise를 반환한다.

6. realm을 this의 관련 영역으로 둔다.

7. promise를 새로운 Promise로 둔다.

8. promise를 반환하고 나머지 단계를 병렬로 수행한다.

9. 다음 단계 또는 참조된 절차에서 오류를 발생시키라고 하는 경우, realm의 전역 객체를 지정하여 암호화 작업 소스에 전역 작업을 대기열에 추가하여 반환된 오류로 promise를 거부한 다음, 알고리즘을 종료한다.

10. normalizedEncapsulationAlgorithm의 name 멤버가 encapsulationKey의 [[algorithm]] 내부 슬롯에 있는 name 속성과 같지 않으면 InvalidAccessError를 발생시킨다.

11. encapsulationKey의 [[usages]] 내부 슬롯에 "encapsulateKey"인 항목이 포함되어 있지 않으면 InvalidAccessError를 발생시킨다.

12. encapsulationKey을 사용하여 encapsulationKey의 [[algorithm]] 내부 슬롯에서 지정한 캡슐화 연산을 수행한 결과를 encapsulatedBits로 둔다.

13. normalizedSharedKeyAlgorithm에서 지정한 키 가져오기 연산을 수행한 결과를 sharedKey로 둔다. 이때 "raw-secret"을 format으로, encapsulatedBits의 sharedKey 필드를 keyData로, sharedKeyAlgorithm을 algorithm으로 사용하고 extractable 및 usages를 사용한다.

14. sharedKey의 [[extractable]] 내부 슬롯을 extractable로 설정한다.

15. sharedKey의 [[usages]] 내부 슬롯을 usages의 정규화된 값으로 설정한다.

16. 새로운 EncapsulatedKey 딕셔너리를 encapsulatedKey로 둔다. 이 딕셔너리의 sharedKey는 sharedKey로 설정하고, ciphertext는 encapsulatedBits의 ciphertext 필드로 설정한다.

17. realm의 전역 객체를 지정하여 암호화 작업 소스에 전역 작업을 대기열에 추가하여 나머지 단계를 수행한다.

18. [WebIDL]에 정의된 대로 encapsulatedKey를 realm의 ECMAScript 객체로 변환한 결과를 result로 둔다.

19. promise를 result로 이행한다.

encapsulateBits(encapsulationAlgorithm, encapsulationKey) 메서드는 키를 캡슐화하고 EncapsulatedBits 객체를 반환한다. 다음과 같이 동작한다.

1. encapsulationAlgorithm 및 encapsulationKey을 각각 encapsulateBits() 메서드에 전달된 encapsulationAlgorithm 및 encapsulationKey 매개변수로 둔다.

2. alg를 encapsulationAlgorithm로 설정하고 op를 "encapsulate"로 설정하여 알고리즘을 정규화한 결과를 normalizedEncapsulationAlgorithm로 둔다.

3. 오류가 발생한 경우 normalizedEncapsulationAlgorithm로 거부된 Promise를 반환한다.

4. realm을 this의 관련 영역으로 둔다.

5. promise를 새로운 Promise로 둔다.

6. promise를 반환하고 나머지 단계를 병렬로 수행한다.

7. 다음 단계 또는 참조된 절차에서 오류를 발생시키라고 하는 경우, realm의 전역 객체를 지정하여 암호화 작업 소스에 전역 작업을 대기열에 추가하여 반환된 오류로 promise를 거부한 다음, 알고리즘을 종료한다.

8. normalizedEncapsulationAlgorithm의 name 멤버가 encapsulationKey의 [[algorithm]] 내부 슬롯에 있는 name 속성과 같지 않으면 InvalidAccessError를 발생시킨다.

9. encapsulationKey의 [[usages]] 내부 슬롯에 "encapsulateBits"인 항목이 포함되어 있지 않으면 InvalidAccessError를 발생시킨다.

10. encapsulationKey을 사용하여 encapsulationKey의 [[algorithm]] 내부 슬롯에서 지정한 캡슐화 연산을 수행한 결과를 encapsulatedBits로 둔다.

11. realm의 전역 객체를 지정하여 암호화 작업 소스에 전역 작업을 대기열에 추가하여 나머지 단계를 수행한다.

12. [WebIDL]에 정의된 대로 encapsulatedBits를 realm의 ECMAScript 객체로 변환한 결과를 result로 둔다.

13. promise를 result로 이행한다.

decapsulateKey(decapsulationAlgorithm, decapsulationKey, ciphertext, sharedKeyAlgorithm, extractable, usages) 메서드는 키의 캡슐화를 해제하고 CryptoKey 객체를 반환한다. 다음과 같이 동작한다.

1. decapsulationAlgorithm, decapsulationKey, sharedKeyAlgorithm, extractable 및 usages를 각각 decapsulateKey() 메서드에 전달된 decapsulationAlgorithm, decapsulationKey, sharedKeyAlgorithm, extractable 및 keyUsages 매개변수로 둔다.

2. alg를 decapsulationAlgorithm로 설정하고 op를 "decapsulate"로 설정하여 알고리즘을 정규화한 결과를 normalizedDecapsulationAlgorithm로 둔다.

3. 오류가 발생한 경우 normalizedDecapsulationAlgorithm로 거부된 Promise를 반환한다.

4. alg를 sharedKeyAlgorithm로 설정하고 op를 "importKey"로 설정하여 알고리즘을 정규화한 결과를 normalizedSharedKeyAlgorithm로 둔다.

5. 오류가 발생한 경우 normalizedSharedKeyAlgorithm로 거부된 Promise를 반환한다.

6. ciphertext를 decapsulateKey() 메서드에 전달된 ciphertext 매개변수가 보유한 바이트의 복사본을 가져온 결과로 둔다.

7. realm을 this의 관련 영역으로 둔다.

8. promise를 새로운 Promise로 둔다.

9. promise를 반환하고 나머지 단계를 병렬로 수행한다.

10. 다음 단계 또는 참조된 절차에서 오류를 발생시키라고 하는 경우, realm의 전역 객체를 지정하여 암호화 작업 소스에 전역 작업을 대기열에 추가하여 반환된 오류로 promise를 거부한 다음, 알고리즘을 종료한다.

11. normalizedDecapsulationAlgorithm의 name 멤버가 decapsulationKey의 [[algorithm]] 내부 슬롯에 있는 name 속성과 같지 않으면 InvalidAccessError를 발생시킨다.

12. decapsulationKey의 [[usages]] 내부 슬롯에 "decapsulateKey"인 항목이 포함되어 있지 않으면 InvalidAccessError를 발생시킨다.

13. decapsulationKey 및 ciphertext를 사용하여 decapsulationKey의 [[algorithm]] 내부 슬롯에서 지정한 캡슐화 해제 연산을 수행한 결과를 decapsulatedBits로 둔다.

14. normalizedSharedKeyAlgorithm에서 지정한 키 가져오기 연산을 수행한 결과를 sharedKey로 둔다. 이때 "raw-secret"을 format으로, decapsulatedBits를 keyData로, sharedKeyAlgorithm을 algorithm으로 사용하고 extractable 및 usages를 사용한다.

15. sharedKey의 [[extractable]] 내부 슬롯을 extractable로 설정한다.

16. sharedKey의 [[usages]] 내부 슬롯을 usages의 정규화된 값으로 설정한다.

17. realm의 전역 객체를 지정하여 암호화 작업 소스에 전역 작업을 대기열에 추가하여 나머지 단계를 수행한다.

18. [WebIDL]에 정의된 대로 sharedKey를 realm의 ECMAScript 객체로 변환한 결과를 result로 둔다.

19. promise를 result로 이행한다.

decapsulateBits(decapsulationAlgorithm, decapsulationKey, ciphertext) 메서드는 키의 캡슐화를 해제하고 ArrayBuffer 객체를 반환한다. 다음과 같이 동작한다.

1. decapsulationAlgorithm 및 decapsulationKey을 각각 decapsulateBits() 메서드에 전달된 decapsulationAlgorithm 및 decapsulationKey 매개변수로 둔다.

2. alg를 decapsulationAlgorithm로 설정하고 op를 "decapsulate"로 설정하여 알고리즘을 정규화한 결과를 normalizedDecapsulationAlgorithm로 둔다.

3. 오류가 발생한 경우 normalizedDecapsulationAlgorithm로 거부된 Promise를 반환한다.

4. ciphertext를 decapsulateBits() 메서드에 전달된 ciphertext 매개변수가 보유한 바이트의 복사본을 가져온 결과로 둔다.

5. realm을 this의 관련 영역으로 둔다.

6. promise를 새로운 Promise로 둔다.

7. promise를 반환하고 나머지 단계를 병렬로 수행한다.

8. 다음 단계 또는 참조된 절차에서 오류를 발생시키라고 하는 경우, realm의 전역 객체를 지정하여 암호화 작업 소스에 전역 작업을 대기열에 추가하여 반환된 오류로 promise를 거부한 다음, 알고리즘을 종료한다.

9. normalizedDecapsulationAlgorithm의 name 멤버가 decapsulationKey의 [[algorithm]] 내부 슬롯에 있는 name 속성과 같지 않으면 InvalidAccessError를 발생시킨다.

10. decapsulationKey의 [[usages]] 내부 슬롯에 "decapsulateBits"인 항목이 포함되어 있지 않으면 InvalidAccessError를 발생시킨다.

11. decapsulationKey 및 ciphertext를 사용하여 decapsulationKey의 [[algorithm]] 내부 슬롯에서 지정한 캡슐화 해제 연산을 수행한 결과를 decapsulatedBits로 둔다.

12. realm의 전역 객체를 지정하여 암호화 작업 소스에 전역 작업을 대기열에 추가하여 나머지 단계를 수행한다.

13. realm에서 decapsulatedBits를 포함하는 ArrayBuffer를 생성한 결과를 result로 둔다.

14. promise를 result로 이행한다.

getPublicKey(key, usages) 메서드는 지정된 비밀 키에 대응하는 공개 키를 반환한다. 다음과 같이 동작한다.

1. key 및 usages를 각각 getPublicKey() 메서드에 전달된 key 및 keyUsages 매개변수로 둔다.

2. algorithm을 key의 [[algorithm]] 내부 슬롯으로 둔다.

3. algorithm이 식별하는 암호 알고리즘이 비밀 키에서 공개 키를 파생하는 기능을 지원하지 않으면 NotSupportedError로 거부된 Promise를 반환한다.

4. realm을 this의 관련 영역으로 둔다.

5. promise를 새로운 Promise로 둔다.

6. promise를 반환하고 나머지 단계를 병렬로 수행한다.

7. 다음 단계 또는 참조된 절차에서 오류를 발생시키라고 하는 경우, realm의 전역 객체를 지정하여 암호화 작업 소스에 전역 작업을 대기열에 추가하여 반환된 오류로 promise를 거부한 다음, 알고리즘을 종료한다.

8. key의 [[type]] 내부 슬롯이 "private"이 아니면 InvalidAccessError를 발생시킨다.

9. usages에 algorithm이 식별하는 알고리즘이 공개 키에 대해 지원하지 않는 항목이 포함되어 있으면 SyntaxError를 발생시킨다.

10. key의 [[handle]] 내부 슬롯이 나타내는 비밀 키에 대응하는 공개 키를 나타내는 새로운 CryptoKey를 publicKey로 둔다.

11. 오류가 발생한 경우 OperationError를 발생시킨다.

12. publicKey의 [[type]] 내부 슬롯을 "public"으로 설정한다.

13. publicKey의 [[algorithm]] 내부 슬롯을 algorithm으로 설정한다.

14. publicKey의 [[extractable]] 내부 슬롯을 true로 설정한다.

15. publicKey의 [[usages]] 내부 슬롯을 usages로 설정한다.

16. realm의 전역 객체를 지정하여 암호화 작업 소스에 전역 작업을 대기열에 추가하여 나머지 단계를 수행한다.

17. [WebIDL]에 정의된 대로 publicKey를 realm의 ECMAScript 객체로 변환한 결과를 result로 둔다.

18. promise를 result로 이행한다.

supports(operation, algorithm, length) 메서드는 지정된 AlgorithmIdentifier를 사용하여 주어진 연산을 구현이 지원하는지 여부를 나타내는 불리언 값을 반환하며, operation이 "deriveBits"일 때 파생할 비트 수를 나타내는 선택적 length 매개변수를 사용한다. 다음과 같이 동작한다:

1. operation이 다음 중 하나가 아니면 "encrypt", "decrypt", "sign", "verify", "digest", "generateKey", "deriveKey", "deriveBits", "importKey", "exportKey", "wrapKey", "unwrapKey", "encapsulateKey", "encapsulateBits", "decapsulateKey", "decapsulateBits" 또는 "getPublicKey", false를 반환한다.

2. 알고리즘 지원 여부를 확인한 결과를 반환한다. 이때 op는 operation으로, alg는 algorithm으로, length는 length로 설정한다.

supports(operation, algorithm, additionalAlgorithm) 메서드는 지정된 AlgorithmIdentifier를 사용하여 주어진 연산을 구현이 지원하는지 여부를 나타내는 불리언 값을 반환한다. 추가 알고리즘은 operation이 "deriveKey"일 때 파생할 키의 유형, operation이 "wrapKey"일 때 래핑하기 전에 내보낼 키의 유형, 그리고 operation이 "unwrapKey"일 때 언래핑한 후 가져올 키의 유형을 나타낸다. 다음과 같이 동작한다:

1. operation이 다음 중 하나가 아니면 "encrypt", "decrypt", "sign", "verify", "digest", "generateKey", "deriveKey", "deriveBits", "importKey", "exportKey", "wrapKey", "unwrapKey", "encapsulateKey", "encapsulateBits", "decapsulateKey", "decapsulateBits" 또는 "getPublicKey", false를 반환한다.

2. operation이 "deriveKey" 또는 "unwrapKey"인 경우:

   알고리즘 지원 여부를 확인한 결과가 op를 "importKey"로 설정하고 alg를 additionalAlgorithm으로 설정했을 때 false이면, false를 반환한다.

   operation이 "wrapKey"인 경우:

   알고리즘 지원 여부를 확인한 결과가 op를 "exportKey"로 설정하고 alg를 additionalAlgorithm으로 설정했을 때 false이면, false를 반환한다.

3. operation이 "encapsulateKey" 또는 "decapsulateKey"인 경우:

   1. normalizedAlgorithm을 알고리즘을 정규화한 결과로 설정한다. 이때 alg는 algorithm으로, op는 "get shared key length"로 설정한다.

   2. 오류가 발생한 경우 false를 반환한다.

   3. sharedKeyLength를 normalizedAlgorithm이 지정한 공유 키 길이 가져오기 알고리즘을 algorithm을 사용하여 수행한 결과로 설정한다.

   4. normalizedAdditionalAlgorithm을 알고리즘을 정규화한 결과로 설정한다. 이때 alg는 additionalAlgorithm으로, op는 "importKey"로 설정한다.

   5. 오류가 발생한 경우 false를 반환한다.

   6. 연산 단계에서 지원 여부를 결정한 결과가 op를 "importKey"로 설정하고 normalizedAlgorithm을 normalizedAdditionalAlgorithm으로 설정하며, length를 null로 설정했을 때 false이면, false를 반환한다.

   7. normalizedAdditionalAlgorithm이 지정한 키 가져오기 연산이 format이 "raw-secret"일 때 비트 단위 길이가 sharedKeyLength인 바이트 시퀀스인 모든 keyData 값에 대해 오류를 발생시키는 경우, false를 반환한다.

4. length를 null로 설정한다.

5. operation이 "deriveKey"인 경우:

   1. 알고리즘 지원 여부를 확인한 결과가 op를 "get key length"로 설정하고 alg를 additionalAlgorithm으로 설정했을 때 false이면, false를 반환한다.

   2. normalizedAdditionalAlgorithm을 알고리즘을 정규화한 결과로 설정한다. 이때 alg는 additionalAlgorithm으로, op는 "get key length"로 설정한다.

   3. length를 additionalAlgorithm이 지정한 키 길이 가져오기 알고리즘을 normalizedAdditionalAlgorithm을 사용하여 수행한 결과로 설정한다.

   4. operation을 "deriveBits"로 설정한다.

6. 알고리즘 지원 여부를 확인한 결과를 반환한다. 이때 op는 operation으로, alg는 algorithm으로, length는 length로 설정한다.

1. key의 [[type]] 내부 슬롯이 "public"이 아닌 경우 예외를 발생시켜 InvalidAccessError로 처리합니다.

2. [FIPS-203]의 섹션 7.2에 설명된 캡슐화 키 검사를 수행합니다. 이때 algorithm의 name 멤버가 나타내는 매개변수 세트를 사용하고, key의 [[handle]] 내부 슬롯이 나타내는 키를 ek 입력 매개변수로 사용합니다.

   참고

   성능을 위해 필요하다면 이 검사의 결과를 CryptoKey 객체에 대해 캐시하거나 미리 계산할 수 있습니다.

3. 캡슐화 키 검사가 실패한 경우 OperationError를 반환합니다.

4. sharedKey와 ciphertext를 [FIPS-203]의 섹션 7.2에 설명된 ML-KEM.Encaps 함수를 수행하여 얻은 출력이라고 합니다. 이때 algorithm의 name 멤버가 나타내는 매개변수 세트를 사용하고, key의 [[handle]] 내부 슬롯이 나타내는 키를 ek 입력 매개변수로 사용합니다.

5. ML-KEM.Encaps 함수가 오류를 반환한 경우 OperationError를 반환합니다.

6. result를 새 EncapsulatedBits 사전이라고 합니다.

7. result의 sharedKey 속성을 sharedKey를 포함하는 ArrayBuffer를 생성한 결과로 설정합니다.

8. result의 ciphertext 속성을 ciphertext를 포함하는 ArrayBuffer를 생성한 결과로 설정합니다.

9. result를 반환합니다.

1. key의 [[type]] 내부 슬롯이 "private"이 아닌 경우 예외를 발생시켜 InvalidAccessError로 처리합니다.

2. [FIPS-203]의 섹션 7.3에 설명된 캡슐화 해제 입력 검사를 수행합니다. 이때 algorithm의 name 멤버가 나타내는 매개변수 세트를 사용하고, key의 [[handle]] 내부 슬롯이 나타내는 키를 dk 입력 매개변수로, ciphertext를 c 입력 매개변수로 사용합니다.

   참고

   성능을 위해 필요하다면 캡슐화 해제 키 유형 검사와 해시 검사의 결과를 CryptoKey 객체에 대해 캐시하거나 미리 계산할 수 있습니다.

3. 캡슐화 해제 키 검사가 실패한 경우 OperationError를 반환합니다.

4. sharedKey를 [FIPS-203]의 섹션 7.3에 설명된 ML-KEM.Decaps 함수를 수행하여 얻은 출력이라고 합니다. 이때 algorithm의 name 멤버가 나타내는 매개변수 세트를 사용하고, key의 [[handle]] 내부 슬롯이 나타내는 키를 dk 입력 매개변수로, ciphertext를 c 입력 매개변수로 사용합니다.

5. sharedKey를 반환합니다.

1. 256을 반환합니다.

1. usages에 "encapsulateKey", "encapsulateBits", "decapsulateKey" 또는 "decapsulateBits" 중 하나가 아닌 항목이 포함되어 있는 경우 예외를 발생시켜 SyntaxError로 처리합니다.

2. [FIPS-203]의 섹션 7.1에 설명된 대로 ML-KEM 키 쌍을 생성하며, normalizedAlgorithm의 name 멤버가 나타내는 매개변수 세트를 사용합니다.

   참고

   시드 (d, z)를 내보낼 수 있도록 하려면, d와 z를 생성된 키 자료의 일부로 저장해야 합니다.

3. 키 생성 단계가 실패한 경우 예외를 발생시켜 OperationError로 처리합니다.

4. algorithm을 새 KeyAlgorithm 객체라고 합니다.

5. algorithm의 name 속성을 normalizedAlgorithm의 name 속성으로 설정합니다.

6. publicKey를 생성된 키 쌍의 캡슐화 키를 나타내는 새 CryptoKey라고 합니다.

7. publicKey의 [[type]] 내부 슬롯을 "public"으로 설정합니다.

8. publicKey의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

9. publicKey의 [[extractable]] 내부 슬롯을 true로 설정합니다.

10. publicKey의 [[usages]] 내부 슬롯을 usages와 [ "encapsulateKey", "encapsulateBits" ]의 용도 교집합으로 설정합니다.

11. privateKey를 생성된 키 쌍의 캡슐화 해제 키를 나타내는 새 CryptoKey라고 합니다.

12. privateKey의 [[type]] 내부 슬롯을 "private"으로 설정합니다.

13. privateKey의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

14. privateKey의 [[extractable]] 내부 슬롯을 extractable로 설정합니다.

15. privateKey의 [[usages]] 내부 슬롯을 usages와 [ "decapsulateKey", "decapsulateBits" ]의 용도 교집합으로 설정합니다.

16. result를 새 CryptoKeyPair 사전이라고 합니다.

17. result의 publicKey 속성을 publicKey로 설정합니다.

18. result의 privateKey 속성을 privateKey로 설정합니다.

19. result를 반환합니다.

1. keyData를 가져올 키 데이터라고 합니다.

2. format이 "spki"인 경우:

   1. usages에 "encapsulateKey" 또는 "encapsulateBits"가 아닌 항목이 포함되어 있는 경우 예외를 발생시켜 SyntaxError로 처리합니다.

   2. spki를 keyData에 대해 subjectPublicKeyInfo 구문 분석 알고리즘을 실행한 결과라고 합니다.

   3. 구문 분석 중 오류가 발생한 경우 예외를 발생시켜 DataError로 처리합니다.

   4. normalizedAlgorithm의 name 멤버가 "ML-KEM-512"인 경우:

      expectedOid를 id-alg-ml-kem-512 (2.16.840.1.101.3.4.4.1)라고 합니다.

      normalizedAlgorithm의 name 멤버가 "ML-KEM-768"인 경우:

      expectedOid를 id-alg-ml-kem-768 (2.16.840.1.101.3.4.4.2)라고 합니다.

      normalizedAlgorithm의 name 멤버가 "ML-KEM-1024"인 경우:

      expectedOid를 id-alg-ml-kem-1024 (2.16.840.1.101.3.4.4.3)라고 합니다.

      그렇지 않은 경우:

      예외를 발생시켜 NotSupportedError로 처리합니다.

   5. spki의 algorithm AlgorithmIdentifier 필드의 algorithm 객체 식별자 필드가 expectedOid와 같지 않은 경우 예외를 발생시켜 DataError로 처리합니다.

   6. spki의 algorithm AlgorithmIdentifier 필드에 parameters 필드가 존재하는 경우 예외를 발생시켜 DataError로 처리합니다.

   7. publicKey를 spki의 subjectPublicKey 필드가 식별하는 ML-KEM 공개 키라고 합니다.

   8. key를 publicKey를 나타내는 새 CryptoKey라고 합니다.

   9. key의 [[type]] 내부 슬롯을 "public"으로 설정합니다.

   10. algorithm을 새 KeyAlgorithm이라고 합니다.

   11. algorithm의 name 속성을 normalizedAlgorithm의 name 속성으로 설정합니다.

   12. key의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

   format이 "pkcs8"인 경우:

   1. usages에 "decapsulateKey" 또는 "decapsulateBits"가 아닌 항목이 포함되어 있는 경우 예외를 발생시켜 SyntaxError로 처리합니다.

   2. privateKeyInfo를 keyData에 대해 privateKeyInfo 구문 분석 알고리즘을 실행한 결과라고 합니다.

   3. 구문 분석 중 오류가 발생하는 경우 예외를 발생시켜 DataError로 처리합니다.

   4. normalizedAlgorithm의 name 멤버가 "ML-KEM-512"인 경우:

      expectedOid를 id-alg-ml-kem-512 (2.16.840.1.101.3.4.4.1)라고 합니다.

      asn1Structure를 ASN.1 ML-KEM-512-PrivateKey 구조라고 합니다.

      normalizedAlgorithm의 name 멤버가 "ML-KEM-768"인 경우:

      expectedOid를 id-alg-ml-kem-768 (2.16.840.1.101.3.4.4.2)라고 합니다.

      asn1Structure를 ASN.1 ML-KEM-768-PrivateKey 구조라고 합니다.

      normalizedAlgorithm의 name 멤버가 "ML-KEM-1024"인 경우:

      expectedOid를 id-alg-ml-kem-1024 (2.16.840.1.101.3.4.4.3)라고 합니다.

      asn1Structure를 ASN.1 ML-KEM-1024-PrivateKey 구조라고 합니다.

      그렇지 않은 경우:

      예외를 발생시켜 NotSupportedError로 처리합니다.

   5. privateKeyInfo의 privateKeyAlgorithm PrivateKeyAlgorithm 필드의 algorithm 객체 식별자 필드가 expectedOid와 같지 않은 경우 예외를 발생시켜 DataError로 처리합니다.

   6. privateKeyInfo의 privateKeyAlgorithm PrivateKeyAlgorithmIdentifier 필드에 parameters 필드가 존재하는 경우 예외를 발생시켜 DataError로 처리합니다.

   7. mlKemPrivateKey를 data에는 privateKeyInfo의 privateKey 필드를, structure에는 asn1Structure를 지정하고 exactData를 true로 설정하여 ASN.1 구조 구문 분석 알고리즘을 수행한 결과라고 합니다.

   8. 구문 분석 중 오류가 발생한 경우 예외를 발생시켜 DataError로 처리합니다.

   9. mlKemPrivateKey가 expandedKey 형식의 ML-KEM 키를 나타내거나, mlKemPrivateKey가 both 형식의 ML-KEM 키를 나타내고 both 형식이 지원되지 않는 경우 NotSupportedError 예외를 발생시킵니다.

   10. mlKemPrivateKey가 both 형식의 ML-KEM 키를 나타내고, seed 필드가 expandedKey 필드와 일치하지 않는 경우 DataError 예외를 발생시킵니다.

   11. key를 mlKemPrivateKey가 식별하는 ML-KEM 비공개 키를 나타내는 새 CryptoKey라고 합니다.

   12. key의 [[type]] 내부 슬롯을 "private"으로 설정합니다.

   13. algorithm을 새 KeyAlgorithm이라고 합니다.

   14. algorithm의 name 속성을 normalizedAlgorithm의 name 속성으로 설정합니다.

   15. key의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

   format이 "raw-public"인 경우:

   1. usages에 "encapsulateKey" 또는 "encapsulateBits"가 아닌 항목이 포함되어 있는 경우 예외를 발생시켜 SyntaxError로 처리합니다.

   2. data를 keyData라고 합니다.

   3. key를 data의 ML-KEM 공개 키 데이터를 나타내는 새 CryptoKey라고 합니다.

   4. key의 [[type]] 내부 슬롯을 "public"으로 설정합니다.

   5. algorithm을 새 KeyAlgorithm이라고 합니다.

   6. algorithm의 name 속성을 normalizedAlgorithm의 name 속성으로 설정합니다.

   7. key의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

   format이 "raw-seed"인 경우:

   1. usages에 "decapsulateKey" 또는 "decapsulateBits"가 아닌 항목이 포함되어 있는 경우 예외를 발생시켜 SyntaxError로 처리합니다.

   2. data를 keyData라고 합니다.

   3. data의 비트 단위 길이가 512가 아닌 경우 예외를 발생시켜 DataError로 처리합니다.

   4. privateKey를 [FIPS-203]의 섹션 6.1에 설명된 ML-KEM.KeyGen_internal 함수를 수행한 결과라고 합니다. 이때 normalizedAlgorithm의 name 멤버가 나타내는 매개변수 세트를 사용하고, data의 처음 256비트를 d로, 마지막 256비트를 z로 사용합니다.

   5. key를 privateKey가 식별하는 ML-KEM 비공개 키를 나타내는 새 CryptoKey라고 합니다.

   6. key의 [[type]] 내부 슬롯을 "private"으로 설정합니다.

   7. algorithm을 새 KeyAlgorithm이라고 합니다.

   8. algorithm의 name 속성을 normalizedAlgorithm의 name 속성으로 설정합니다.

   9. key의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

   format이 "jwk"인 경우:

   1. keyData가 JsonWebKey 사전인 경우:

      jwk를 keyData와 같다고 합니다.

      그렇지 않은 경우:

      예외를 발생시켜 DataError로 처리합니다.

   2. jwk의 priv 필드가 존재하고 usages에 "decapsulateKey" 또는 "decapsulateBits"가 아닌 항목이 포함되어 있는 경우 예외를 발생시켜 SyntaxError로 처리합니다.

   3. jwk의 priv 필드가 존재하지 않고 usages에 "encapsulateKey" 또는 "encapsulateBits"가 아닌 항목이 포함되어 있는 경우 예외를 발생시켜 SyntaxError로 처리합니다.

   4. jwk의 kty 필드가 "AKP"가 아닌 경우 예외를 발생시켜 DataError로 처리합니다.

   5. jwk의 alg 필드가 존재하지 않거나, 그 값이 normalizedAlgorithm의 name 멤버가 나타내는 ML-KEM 매개변수 세트를 식별하지 않는 경우 예외를 발생시켜 DataError로 처리합니다.

      참고

      이 명세에서 정의한 ML-KEM 매개변수 세트에 대해 IANA JSON 웹 서명 및 암호화 알고리즘 레지스트리에 등록된 "alg" 값은 ML-KEM-512, ML-KEM-768, ML-KEM-1024입니다. 구현은 동일한 ML-KEM 매개변수 세트를 사용하는 JWE 알고리즘을 식별하는 이 레지스트리의 다른 값도 허용해야 합니다. 단, 해당 JWE 알고리즘의 JWK 표현은 "alg" 값을 제외하고 여기서 정의한 표현과 호환되어야 합니다. 예로는 등록된 이후의 [draft-ietf-jose-hpke-pq-pqt]에서 제안한 값이 있습니다.

   6. usages가 비어 있지 않고 jwk의 use 필드가 존재하며 "enc"와 같지 않은 경우 예외를 발생시켜 DataError로 처리합니다.

   7. jwk의 key_ops 필드가 존재하면서 JSON 웹 키 [JWK]의 요구사항에 따라 유효하지 않거나, 지정된 usages 값을 모두 포함하지 않는 경우 예외를 발생시켜 DataError로 처리합니다.

   8. jwk의 ext 필드가 존재하고 그 값이 false이며 extractable이 true인 경우 예외를 발생시켜 DataError로 처리합니다.

   9. jwk의 priv 필드가 존재하는 경우:

      1. jwk의 priv 속성에 ML-KEM 비공개 키를 나타내는 유효한 base64url 인코딩 시드가 포함되어 있지 않은 경우 예외를 발생시켜 DataError로 처리합니다.

      2. key를 jwk의 priv 속성을 base64url 인코딩 시드로 해석하여 식별한 ML-KEM 비공개 키를 나타내는 새 CryptoKey 객체라고 합니다.

      3. key의 [[type]] 내부 슬롯을 "private"으로 설정합니다.

      4. jwk의 pub 속성에 key에 대응하는 ML-KEM 공개 키를 나타내는 base64url 인코딩 공개 키가 포함되어 있지 않은 경우 예외를 발생시켜 DataError로 처리합니다.

      그렇지 않은 경우:

      1. jwk의 pub 속성에 ML-KEM 공개 키를 나타내는 유효한 base64url 인코딩 공개 키가 포함되어 있지 않은 경우 예외를 발생시켜 DataError로 처리합니다.

      2. key를 jwk의 pub 속성을 base64url 인코딩 공개 키로 해석하여 식별한 ML-KEM 공개 키를 나타내는 새 CryptoKey 객체라고 합니다.

      3. key의 [[type]] 내부 슬롯을 "public"으로 설정합니다.

   10. algorithm을 새 KeyAlgorithm 객체의 인스턴스라고 합니다.

   11. algorithm의 name 속성을 normalizedAlgorithm의 name 멤버로 설정합니다.

   12. key의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

   그렇지 않은 경우:

   예외를 발생시켜 NotSupportedError로 처리합니다.

3. key를 반환합니다.

1. key를 내보낼 CryptoKey라고 합니다.

2. key의 [[handle]] 내부 슬롯이 나타내는 기반 암호화 키 자료에 접근할 수 없는 경우 예외를 발생시켜 OperationError로 처리합니다.

3. format이 "spki"인 경우:

   1. key의 [[type]] 내부 슬롯이 "public"이 아닌 경우 예외를 발생시켜 InvalidAccessError로 처리합니다.

   2. keyAlgorithm을 key의 [[algorithm]] 내부 슬롯이라고 합니다.

   3. data를 [RFC5280]에 정의된 SubjectPublicKeyInfo ASN.1 구조의 인스턴스로 하며 다음 속성을 갖도록 합니다.

      • algorithm 필드를 다음 속성을 갖는 AlgorithmIdentifier ASN.1 유형으로 설정합니다.

        • keyAlgorithm의 name 멤버가 "ML-KEM-512"인 경우:

          algorithm 객체 식별자를 id-alg-ml-kem-512 (2.16.840.1.101.3.4.4.1) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "ML-KEM-768"인 경우:

          algorithm 객체 식별자를 id-alg-ml-kem-768 (2.16.840.1.101.3.4.4.2) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "ML-KEM-1024"인 경우:

          algorithm 객체 식별자를 id-alg-ml-kem-1024 (2.16.840.1.101.3.4.4.3) OID로 설정합니다.

          그렇지 않은 경우:

          예외를 발생시켜 NotSupportedError로 처리합니다.

      • subjectPublicKey 필드를 keyData로 설정합니다.

   4. result를 data를 DER 인코딩한 결과라고 합니다.

   format이 "pkcs8"인 경우:

   1. key의 [[type]] 내부 슬롯이 "private"이 아닌 경우 예외를 발생시켜 InvalidAccessError로 처리합니다.

   2. keyAlgorithm을 key의 [[algorithm]] 내부 슬롯이라고 합니다.

   3. data를 [RFC5208]에 정의된 PrivateKeyInfo ASN.1 구조의 인스턴스로 하며 다음 속성을 갖도록 합니다.

      • version 필드를 0으로 설정합니다.

      • privateKeyAlgorithm 필드를 다음 속성을 갖는 PrivateKeyAlgorithmIdentifier ASN.1 유형으로 설정합니다.

        • keyAlgorithm의 name 멤버가 "ML-KEM-512"인 경우:

          algorithm 객체 식별자를 id-alg-ml-kem-512 (2.16.840.1.101.3.4.4.1) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "ML-KEM-768"인 경우:

          algorithm 객체 식별자를 id-alg-ml-kem-768 (2.16.840.1.101.3.4.4.2) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "ML-KEM-1024"인 경우:

          algorithm 객체 식별자를 id-alg-ml-kem-1024 (2.16.840.1.101.3.4.4.3) OID로 설정합니다.

          그렇지 않은 경우:

          예외를 발생시켜 NotSupportedError로 처리합니다.

      • privateKey 필드를 다음과 같이 설정합니다.

        • keyAlgorithm의 name 멤버가 "ML-KEM-512"인 경우:

          privateKey 필드를 key의 [[handle]] 내부 슬롯이 나타내는 ML-KEM 비공개 키 시드를 시드 전용 형식(암시적 OCTET STRING 인코딩을 사용하는 컨텍스트별 [0] 기본 태그 사용)으로 나타내는 ML-KEM-512-PrivateKey ASN.1 유형을 DER 인코딩한 결과로 설정합니다.

          keyAlgorithm의 name 멤버가 "ML-KEM-768"인 경우:

          privateKey 필드를 key의 [[handle]] 내부 슬롯이 나타내는 ML-KEM 비공개 키 시드를 시드 전용 형식(암시적 OCTET STRING 인코딩을 사용하는 컨텍스트별 [0] 기본 태그 사용)으로 나타내는 ML-KEM-768-PrivateKey ASN.1 유형을 DER 인코딩한 결과로 설정합니다.

          keyAlgorithm의 name 멤버가 "ML-KEM-1024"인 경우:

          privateKey 필드를 key의 [[handle]] 내부 슬롯이 나타내는 ML-KEM 비공개 키 시드를 시드 전용 형식(암시적 OCTET STRING 인코딩을 사용하는 컨텍스트별 [0] 기본 태그 사용)으로 나타내는 ML-KEM-1024-PrivateKey ASN.1 유형을 DER 인코딩한 결과로 설정합니다.

          그렇지 않은 경우:

          예외를 발생시켜 NotSupportedError로 처리합니다.

   4. result를 data를 DER 인코딩한 결과라고 합니다.

   format이 "raw-public"인 경우:

   1. key의 [[type]] 내부 슬롯이 "public"이 아닌 경우 예외를 발생시켜 InvalidAccessError로 처리합니다.

   2. data를 key의 [[handle]] 내부 슬롯이 나타내는 키의 원시 옥텟을 포함하는 바이트 시퀀스라고 합니다.

   3. result를 data라고 합니다.

   format이 "raw-seed"인 경우:

   1. key의 [[type]] 내부 슬롯이 "private"이 아닌 경우 예외를 발생시켜 InvalidAccessError로 처리합니다.

   2. data를 key의 [[handle]] 내부 슬롯이 나타내는 키의 d 및 z 시드 변수를 연결한 값을 포함하는 바이트 시퀀스라고 합니다.

      참고

      d 및 z 시드 변수는 [FIPS-203]의 섹션 7.1에 설명된 대로 ML-KEM.KeyGen 함수에서 샘플링되었습니다.

   3. result를 data라고 합니다.

   format이 "jwk"인 경우:

   1. jwk를 새 JsonWebKey 사전이라고 합니다.

   2. keyAlgorithm을 key의 [[algorithm]] 내부 슬롯이라고 합니다.

   3. jwk의 kty 속성을 "AKP"로 설정합니다.

   4. jwk의 alg 속성을 keyAlgorithm의 name 멤버로 설정합니다.

   5. jwk의 pub 속성을 key의 [[handle]] 내부 슬롯에 대응하는 base64url 인코딩 공개 키로 설정합니다.

   6. key의 [[type]] 내부 슬롯이 "private"인 경우:

      jwk의 priv 속성을 key의 [[handle]] 내부 슬롯이 나타내는 base64url 인코딩 시드로 설정합니다.

   7. jwk의 key_ops 속성을 key의 usages 속성으로 설정합니다.

   8. jwk의 ext 속성을 key의 [[extractable]] 내부 슬롯으로 설정합니다.

   9. result를 jwk라고 합니다.

   그렇지 않은 경우:

   예외를 발생시켜 NotSupportedError로 처리합니다.

4. result를 반환합니다.

1. key의 [[type]] 내부 슬롯이 "public"이 아니면, InvalidAccessError를 던집니다.

2. sharedKey 및 ciphertext를 [draft-irtf-cfrg-concrete-hybrid-kems-04]의 섹션 4에서 algorithm의 name 멤버가 나타내는 하이브리드 KEM 인스턴스에 대해 Encaps 함수를 수행하여 얻은 출력으로 설정하며, key의 [[handle]] 내부 슬롯이 나타내는 키를 ek 입력 매개변수로 사용합니다.

3. Encaps 함수가 오류를 반환한 경우 OperationError를 반환합니다.

4. result를 새로운 EncapsulatedBits 사전으로 설정합니다.

5. result의 sharedKey 속성을 sharedKey를 포함하는 ArrayBuffer를 생성한 결과로 설정합니다.

6. result의 ciphertext 속성을 ciphertext를 포함하는 ArrayBuffer를 생성한 결과로 설정합니다.

7. result를 반환합니다.

1. key의 [[type]] 내부 슬롯이 "private"이 아니면, InvalidAccessError를 던집니다.

2. sharedKey를 [draft-irtf-cfrg-concrete-hybrid-kems-04]의 섹션 4에서 algorithm의 name 멤버가 나타내는 하이브리드 KEM 인스턴스에 대해 Decaps 함수를 수행하여 얻은 출력으로 설정하며, key의 [[handle]] 내부 슬롯이 나타내는 키를 dk 입력 매개변수로 사용하고, ciphertext를 ct 입력 매개변수로 사용합니다.

3. Decaps 함수가 오류를 반환한 경우 OperationError를 반환합니다.

4. sharedKey를 반환합니다.

1. 256을 반환합니다.

1. usages에 "encapsulateKey", "encapsulateBits", "decapsulateKey" 또는 "decapsulateBits" 중 하나가 아닌 항목이 포함되어 있으면, SyntaxError를 던집니다.

2. [draft-irtf-cfrg-hybrid-kems-12]의 섹션 5.2에 설명된 GenerateKeyPair 함수를 normalizedAlgorithm의 name 멤버가 나타내는 하이브리드 KEM 인스턴스로 수행하여 하이브리드 KEM 키 쌍을 생성합니다.

3. 키 생성 단계가 실패하면, OperationError를 던집니다.

4. algorithm을 새로운 KeyAlgorithm 객체로 설정합니다.

5. algorithm의 name 속성을 normalizedAlgorithm의 name 속성으로 설정합니다.

6. publicKey를 생성된 키 쌍의 캡슐화 키를 나타내는 새로운 CryptoKey로 설정합니다.

7. publicKey의 [[type]] 내부 슬롯을 "public"으로 설정합니다.

8. publicKey의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

9. publicKey의 [[extractable]] 내부 슬롯을 true로 설정합니다.

10. publicKey의 [[usages]] 내부 슬롯을 usages와 [ "encapsulateKey", "encapsulateBits" ]의 용도 교집합으로 설정합니다.

11. privateKey를 생성된 키 쌍의 캡슐화 해제 키를 나타내는 새로운 CryptoKey로 설정합니다.

12. privateKey의 [[type]] 내부 슬롯을 "private"으로 설정합니다.

13. privateKey의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

14. privateKey의 [[extractable]] 내부 슬롯을 extractable로 설정합니다.

15. privateKey의 [[usages]] 내부 슬롯을 usages와 [ "decapsulateKey", "decapsulateBits" ]의 용도 교집합으로 설정합니다.

16. result를 새로운 CryptoKeyPair 사전으로 설정합니다.

17. result의 publicKey 속성을 publicKey로 설정합니다.

18. result의 privateKey 속성을 privateKey로 설정합니다.

19. result를 반환합니다.

1. keyData를 가져올 키 데이터로 설정합니다.

2. format이 "raw-public"인 경우:

   1. usages에 "encapsulateKey" 또는 "encapsulateBits"가 아닌 항목이 포함되어 있으면 SyntaxError를 던집니다.

   2. data를 keyData로 설정합니다.

   3. data의 바이트 단위 길이가 [draft-irtf-cfrg-concrete-hybrid-kems-04]의 섹션 4에서 normalizedAlgorithm의 name 멤버가 나타내는 하이브리드 KEM 인스턴스의 원시 공개 키 길이 Nek와 같지 않으면, DataError를 던집니다.

   4. key를 data의 하이브리드 KEM 공개 키 데이터를 나타내는 새로운 CryptoKey로 설정합니다.

   5. key의 [[type]] 내부 슬롯을 "public"으로 설정합니다.

   6. algorithm을 새로운 KeyAlgorithm으로 설정합니다.

   7. algorithm의 name 속성을 normalizedAlgorithm의 name 속성으로 설정합니다.

   8. key의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

   format이 "raw-seed"인 경우:

   1. usages에 "decapsulateKey" 또는 "decapsulateBits"가 아닌 항목이 포함되어 있으면 SyntaxError를 던집니다.

   2. data를 keyData로 설정합니다.

   3. data의 비트 단위 길이가 256이 아니면 DataError를 던집니다.

   4. keyPair를 [draft-irtf-cfrg-hybrid-kems-12]의 섹션 5.5에 설명된 DeriveKeyPair 함수를 normalizedAlgorithm의 name 멤버가 나타내는 하이브리드 KEM 인스턴스로 수행한 결과로 설정하며, data를 seed 입력 매개변수로 사용합니다.

   5. DeriveKeyPair 함수가 오류를 반환한 경우, OperationError를 던집니다.

   6. key를 keyPair의 캡슐화 해제 키로 식별되는 하이브리드 KEM 개인 키를 나타내는 새로운 CryptoKey로 설정합니다.

   7. key의 [[type]] 내부 슬롯을 "private"으로 설정합니다.

   8. algorithm을 새로운 KeyAlgorithm으로 설정합니다.

   9. algorithm의 name 속성을 normalizedAlgorithm의 name 속성으로 설정합니다.

   10. key의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

   format이 "jwk"인 경우:

   1. keyData가 JsonWebKey 사전인 경우:

      jwk를 keyData와 같게 설정합니다.

      그렇지 않은 경우:

      DataError를 던집니다.

   2. jwk의 priv 필드가 존재하고, usages에 "decapsulateKey" 또는 "decapsulateBits"가 아닌 항목이 포함되어 있으면 SyntaxError를 던집니다.

   3. jwk의 priv 필드가 존재하지 않고, usages에 "encapsulateKey" 또는 "encapsulateBits"가 아닌 항목이 포함되어 있으면 SyntaxError를 던집니다.

   4. jwk의 kty 필드가 "AKP"가 아니면, DataError를 던집니다.

   5. jwk의 alg 필드가 존재하지 않거나, 그 값이 normalizedAlgorithm의 name 멤버가 나타내는 하이브리드 KEM 인스턴스를 식별하지 않으면, DataError를 던집니다.

      참고

      이 명세에서 정의한 하이브리드 KEM 인스턴스에 대해 IANA JSON 웹 서명 및 암호화 알고리즘 레지스트리에 등록된 "alg" 값은 MLKEM768-P256, MLKEM768-X25519 및 MLKEM1024-P384입니다. 구현은 동일한 하이브리드 KEM 인스턴스를 사용하는 JWE 알고리즘을 식별하는 이 레지스트리의 다른 값도 허용해야 합니다. 단, 해당 JWE 알고리즘의 JWK 표현은 "alg" 값을 제외하고 여기에서 정의한 표현과 호환되어야 합니다. 예로는 등록된 이후의 [draft-ietf-jose-hpke-pq-pqt]에서 제안한 값이 있습니다.

   6. usages가 비어 있지 않고 jwk의 use 필드가 존재하며 "enc"와 같지 않으면, DataError를 던집니다.

   7. jwk의 key_ops 필드가 존재하며, JSON Web Key [JWK]의 요구사항에 따라 유효하지 않거나, 지정된 모든 usages 값을 포함하지 않으면, DataError를 던집니다.

   8. jwk의 ext 필드가 존재하며 값이 false이고 extractable이 true이면, DataError를 던집니다.

   9. jwk의 priv 필드가 존재하는 경우:

      1. jwk의 priv 속성이 하이브리드 KEM 개인 키를 나타내는 유효한 base64url 인코딩 32바이트 시드를 포함하지 않으면, DataError를 던집니다.

      2. key를 jwk의 priv 속성을 base64url로 인코딩된 시드로 해석하여 식별되는 하이브리드 KEM 개인 키를 나타내는 새로운 CryptoKey 객체로 설정합니다.

      3. key의 [[type]] 내부 슬롯을 "private"으로 설정합니다.

      4. jwk의 pub 속성이 key에 대응하는 하이브리드 KEM 공개 키를 나타내는 base64url 인코딩 공개 키를 포함하지 않으면, DataError를 던집니다.

      그렇지 않은 경우:

      1. jwk의 pub 속성이 [draft-irtf-cfrg-concrete-hybrid-kems-04]의 섹션 4에서 normalizedAlgorithm의 name 멤버가 나타내는 하이브리드 KEM 인스턴스에 대해 길이가 Nek인 유효한 base64url 인코딩 원시 공개 키를 포함하지 않으면, DataError를 던집니다.

      2. key를 jwk의 pub 속성을 base64url로 인코딩된 공개 키로 해석하여 식별되는 하이브리드 KEM 공개 키를 나타내는 새로운 CryptoKey 객체로 설정합니다.

      3. key의 [[type]] 내부 슬롯을 "public"으로 설정합니다.

   10. algorithm을 새로운 KeyAlgorithm 객체의 인스턴스로 설정합니다.

   11. algorithm의 name 속성을 normalizedAlgorithm의 name 멤버로 설정합니다.

   12. key의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

   그렇지 않은 경우:

   NotSupportedError를 던집니다.

3. key를 반환합니다.

1. key를 내보낼 CryptoKey로 설정합니다.

2. key의 [[handle]] 내부 슬롯이 나타내는 기본 암호화 키 재료에 접근할 수 없으면, OperationError를 던집니다.

3. format이 "raw-public"인 경우:

   1. key의 [[type]] 내부 슬롯이 "public"이 아니면, InvalidAccessError를 던집니다.

   2. data를 key의 [[handle]] 내부 슬롯이 나타내는 키의 원시 옥텟을 포함하는 바이트 시퀀스로 설정합니다.

   3. result를 data로 설정합니다.

   format이 "raw-seed"인 경우:

   1. key의 [[type]] 내부 슬롯이 "private"이 아니면, InvalidAccessError를 던집니다.

   2. data를 key의 [[handle]] 내부 슬롯이 나타내는 32바이트 시드를 포함하는 바이트 시퀀스로 설정합니다.

   3. result를 data로 설정합니다.

   format이 "jwk"인 경우:

   1. jwk를 새로운 JsonWebKey 사전으로 설정합니다.

   2. keyAlgorithm을 key의 [[algorithm]] 내부 슬롯으로 설정합니다.

   3. jwk의 kty 속성을 "AKP"로 설정합니다.

   4. jwk의 alg 속성을 keyAlgorithm의 name 멤버로 설정합니다.

   5. jwk의 pub 속성을 key의 [[handle]] 내부 슬롯에 대응하는 base64url 인코딩 공개 키로 설정합니다.

   6. key의 [[type]] 내부 슬롯이 "private"인 경우:

      jwk의 priv 속성을 key의 [[handle]] 내부 슬롯이 나타내는 base64url 인코딩 32바이트 시드로 설정합니다.

   7. jwk의 key_ops 속성을 key의 usages 속성으로 설정합니다.

   8. jwk의 ext 속성을 key의 [[extractable]] 내부 슬롯으로 설정합니다.

   9. result를 jwk로 설정합니다.

   그렇지 않은 경우:

   NotSupportedError를 던집니다.

4. result를 반환합니다.

1. normalizedAlgorithm의 context 멤버가 존재하고 길이가 255 바이트보다 크면, OperationError를 던집니다.

2. key의 [[type]] 내부 슬롯이 "private"이 아니면, InvalidAccessError를 던집니다.

3. context를 normalizedAlgorithm의 context 멤버로 설정하거나, normalizedAlgorithm의 context 멤버가 존재하지 않는 경우 빈 옥텟 문자열로 설정합니다.

4. result를 [FIPS-204]의 섹션 5.2에 명시된 ML-DSA.Sign 서명 알고리즘을 수행한 결과로 설정합니다. 이때 normalizedAlgorithm의 name 멤버가 나타내는 매개변수 집합을 사용하고, key와 연결된 ML-DSA 개인 키를 sk로, message를 M으로, context를 ctx로 사용합니다.

5. ML-DSA.Sign 알고리즘이 오류를 반환한 경우 OperationError를 반환합니다.

6. result를 반환합니다.

1. normalizedAlgorithm의 context 멤버가 존재하고 길이가 255 바이트보다 크면, OperationError를 던집니다.

2. key의 [[type]] 내부 슬롯이 "public"이 아니면, InvalidAccessError를 던집니다.

3. context를 normalizedAlgorithm의 context 멤버로 설정하거나, normalizedAlgorithm의 context 멤버가 존재하지 않는 경우 빈 옥텟 문자열로 설정합니다.

4. result를 [FIPS-204]의 섹션 5.3에 명시된 ML-DSA.Verify 검증 알고리즘을 수행한 결과로 설정합니다. 이때 normalizedAlgorithm의 name 멤버가 나타내는 매개변수 집합을 사용하고, key와 연결된 ML-DSA 공개 키를 pk로, message를 M으로, signature를 σ로, context를 ctx로 사용합니다.

5. ML-DSA.Verify 알고리즘이 오류를 반환한 경우 OperationError를 반환합니다.

6. result를 반환합니다.

1. usages에 "sign" 또는 "verify" 중 하나가 아닌 항목이 포함되어 있으면, SyntaxError를 던집니다.

2. [FIPS-204]의 섹션 5.1에 설명된 대로, normalizedAlgorithm의 name 멤버가 나타내는 매개변수 집합을 사용하여 ML-DSA 키 쌍을 생성합니다.

   참고

   시드 ξ를 내보낼 수 있도록 하려면, 생성된 키 재료의 일부로 저장해야 합니다.

3. 키 생성 단계가 실패하면, OperationError를 던집니다.

4. algorithm을 새로운 KeyAlgorithm 객체로 설정합니다.

5. algorithm의 name 속성을 normalizedAlgorithm의 name 속성으로 설정합니다.

6. publicKey를 생성된 키 쌍의 공개 키를 나타내는 새로운 CryptoKey로 설정합니다.

7. publicKey의 [[type]] 내부 슬롯을 "public"으로 설정합니다.

8. publicKey의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

9. publicKey의 [[extractable]] 내부 슬롯을 true로 설정합니다.

10. publicKey의 [[usages]] 내부 슬롯을 usages와 [ "verify" ]의 용도 교집합으로 설정합니다.

11. privateKey를 생성된 키 쌍의 개인 키를 나타내는 새로운 CryptoKey로 설정합니다.

12. privateKey의 [[type]] 내부 슬롯을 "private"으로 설정합니다.

13. privateKey의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

14. privateKey의 [[extractable]] 내부 슬롯을 extractable로 설정합니다.

15. privateKey의 [[usages]] 내부 슬롯을 usages와 [ "sign" ]의 용도 교집합으로 설정합니다.

16. result를 새로운 CryptoKeyPair 사전으로 설정합니다.

17. result의 publicKey 속성을 publicKey로 설정합니다.

18. result의 privateKey 속성을 privateKey로 설정합니다.

19. result를 반환합니다.

1. keyData를 가져올 키 데이터로 설정합니다.

2. format이 "spki"인 경우:

   1. usages에 "verify"가 아닌 항목이 포함되어 있으면, SyntaxError를 던집니다.

   2. spki를 keyData에 대해 subjectPublicKeyInfo 파싱 알고리즘을 실행한 결과로 설정합니다.

   3. 파싱 중 오류가 발생하면, DataError를 던집니다.

   4. normalizedAlgorithm의 name 멤버가 "ML-DSA-44"인 경우:

      expectedOid를 id-ml-dsa-44 (2.16.840.1.101.3.4.3.17)로 설정합니다.

      normalizedAlgorithm의 name 멤버가 "ML-DSA-65"인 경우:

      expectedOid를 id-ml-dsa-65 (2.16.840.1.101.3.4.3.18)로 설정합니다.

      normalizedAlgorithm의 name 멤버가 "ML-DSA-87"인 경우:

      expectedOid를 id-ml-dsa-87 (2.16.840.1.101.3.4.3.19)로 설정합니다.

      그렇지 않은 경우:

      NotSupportedError를 던집니다.

   5. spki의 algorithm AlgorithmIdentifier 필드의 algorithm 객체 식별자 필드가 expectedOid와 같지 않으면, DataError를 던집니다.

   6. spki의 algorithm AlgorithmIdentifier 필드에 parameters 필드가 존재하면, DataError를 던집니다.

   7. publicKey를 spki의 subjectPublicKey 필드가 식별하는 ML-DSA 공개 키로 설정합니다.

   8. key를 publicKey를 나타내는 새로운 CryptoKey로 설정합니다.

   9. key의 [[type]] 내부 슬롯을 "public"으로 설정합니다.

   10. algorithm을 새로운 KeyAlgorithm으로 설정합니다.

   11. algorithm의 name 속성을 normalizedAlgorithm의 name 속성으로 설정합니다.

   12. key의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

   format이 "pkcs8"인 경우:

   1. usages에 "sign"이 아닌 항목이 포함되어 있으면, SyntaxError를 던집니다.

   2. privateKeyInfo를 keyData에 대해 privateKeyInfo 파싱 알고리즘을 실행한 결과로 설정합니다.

   3. 파싱 중 오류가 발생하면, DataError를 던집니다.

   4. normalizedAlgorithm의 name 멤버가 "ML-DSA-44"인 경우:

      expectedOid를 id-ml-dsa-44 (2.16.840.1.101.3.4.3.17)로 설정합니다.

      asn1Structure를 ASN.1 ML-DSA-44-PrivateKey 구조로 설정합니다.

      normalizedAlgorithm의 name 멤버가 "ML-DSA-65"인 경우:

      expectedOid를 id-ml-dsa-65 (2.16.840.1.101.3.4.3.18)로 설정합니다.

      asn1Structure를 ASN.1 ML-DSA-65-PrivateKey 구조로 설정합니다.

      normalizedAlgorithm의 name 멤버가 "ML-DSA-87"인 경우:

      expectedOid를 id-ml-dsa-87 (2.16.840.1.101.3.4.3.19)로 설정합니다.

      asn1Structure를 ASN.1 ML-DSA-87-PrivateKey 구조로 설정합니다.

      그렇지 않은 경우:

      NotSupportedError를 던집니다.

   5. privateKeyInfo의 privateKeyAlgorithm PrivateKeyAlgorithm 필드의 algorithm 객체 식별자 필드가 expectedOid와 같지 않으면, DataError를 던집니다.

   6. privateKeyInfo의 privateKeyAlgorithm PrivateKeyAlgorithmIdentifier 필드에 parameters 필드가 존재하면, DataError를 던집니다.

   7. mlDsaPrivateKey를 ASN.1 구조 파싱 알고리즘을 수행한 결과로 설정합니다. 이때 data에는 privateKeyInfo의 privateKey 필드를, structure에는 asn1Structure를 사용하고, exactData는 true로 설정합니다.

   8. 파싱 중 오류가 발생하면, DataError를 던집니다.

   9. mlDsaPrivateKey가 expandedKey 형식의 ML-DSA 키를 나타내거나, mlDsaPrivateKey가 both 형식의 ML-DSA 키를 나타내며 both 형식이 지원되지 않는 경우, NotSupportedError를 던집니다.

   10. mlDsaPrivateKey가 both 형식의 ML-DSA 키를 나타내고, seed 필드가 expandedKey 필드에 대응하지 않으면, DataError를 던집니다.

   11. key를 mlDsaPrivateKey가 식별하는 ML-DSA 개인 키를 나타내는 새로운 CryptoKey로 설정합니다.

   12. key의 [[type]] 내부 슬롯을 "private"으로 설정합니다.

   13. algorithm을 새로운 KeyAlgorithm으로 설정합니다.

   14. algorithm의 name 속성을 normalizedAlgorithm의 name 속성으로 설정합니다.

   15. key의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

   format이 "raw-public"인 경우:

   1. usages에 "verify"가 아닌 항목이 포함되어 있으면, SyntaxError를 던집니다.

   2. algorithm을 새로운 KeyAlgorithm 객체로 설정합니다.

   3. algorithm의 name 속성을 normalizedAlgorithm의 name 속성으로 설정합니다.

   4. key를 keyData에 제공된 키 데이터를 나타내는 새로운 CryptoKey로 설정합니다.

   5. key의 [[type]] 내부 슬롯을 "public"으로 설정합니다.

   6. key의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

   format이 "raw-seed"인 경우:

   1. usages에 "sign"이 아닌 항목이 포함되어 있으면, SyntaxError를 던집니다.

   2. data를 keyData로 설정합니다.

   3. data의 비트 단위 길이가 256이 아니면, DataError를 던집니다.

   4. privateKey를 [FIPS-204]의 섹션 6.1에 설명된 ML-DSA.KeyGen_internal 함수를 normalizedAlgorithm의 name 멤버가 나타내는 매개변수 집합으로 수행한 결과로 설정하며, data를 ξ로 사용합니다.

   5. key를 privateKey가 식별하는 ML-DSA 개인 키를 나타내는 새로운 CryptoKey로 설정합니다.

   6. key의 [[type]] 내부 슬롯을 "private"으로 설정합니다.

   7. algorithm을 새로운 KeyAlgorithm으로 설정합니다.

   8. algorithm의 name 속성을 normalizedAlgorithm의 name 속성으로 설정합니다.

   9. key의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

   format이 "jwk"인 경우:

   1. keyData가 JsonWebKey 사전인 경우:

      jwk를 keyData와 같게 설정합니다.

      그렇지 않은 경우:

      DataError를 던집니다.

   2. priv 필드가 존재하고 usages에 "sign"이 아닌 항목이 포함되어 있거나, priv 필드가 존재하지 않고 usages에 "verify"가 아닌 항목이 포함되어 있으면, SyntaxError를 던집니다.

   3. jwk의 kty 필드가 "AKP"가 아니면, DataError를 던집니다.

   4. jwk의 alg 필드가 normalizedAlgorithm의 name 멤버와 같지 않으면, DataError를 던집니다.

   5. usages가 비어 있지 않고 jwk의 use 필드가 존재하며 "sig"와 같지 않으면, DataError를 던집니다.

   6. jwk의 key_ops 필드가 존재하며 JSON Web Key [JWK]의 요구사항에 따라 유효하지 않거나, 지정된 모든 usages 값을 포함하지 않으면, DataError를 던집니다.

   7. jwk의 ext 필드가 존재하고 값이 false이며 extractable이 true이면, DataError를 던집니다.

   8. jwk의 priv 필드가 존재하는 경우:

      1. jwk의 priv 속성이 ML-DSA 개인 키를 나타내는 유효한 base64url 인코딩 시드를 포함하지 않으면, DataError를 던집니다.

      2. key를 jwk의 priv 속성을 base64url로 인코딩된 시드로 해석하여 식별되는 ML-DSA 개인 키를 나타내는 새로운 CryptoKey 객체로 설정합니다.

      3. key의 [[type]] 내부 슬롯을 "private"으로 설정합니다.

      4. jwk의 pub 속성이 key에 대응하는 ML-DSA 공개 키를 나타내는 base64url 인코딩 공개 키를 포함하지 않으면, DataError를 던집니다.

      그렇지 않은 경우:

      1. jwk의 pub 속성이 ML-DSA 공개 키를 나타내는 유효한 base64url 인코딩 공개 키를 포함하지 않으면, DataError를 던집니다.

      2. key를 jwk의 pub 속성을 base64url로 인코딩된 공개 키로 해석하여 식별되는 ML-DSA 공개 키를 나타내는 새로운 CryptoKey 객체로 설정합니다.

      3. key의 [[type]] 내부 슬롯을 "public"으로 설정합니다.

   9. algorithm을 새로운 KeyAlgorithm 객체의 인스턴스로 설정합니다.

   10. algorithm의 name 속성을 normalizedAlgorithm의 name 멤버로 설정합니다.

   11. key의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

   그렇지 않은 경우:

   NotSupportedError를 던집니다.

3. key를 반환합니다.

1. key를 내보낼 CryptoKey로 설정합니다.

2. key의 [[handle]] 내부 슬롯이 나타내는 기본 암호화 키 재료에 접근할 수 없으면, OperationError를 던집니다.

3. format이 "spki"인 경우:

   1. key의 [[type]] 내부 슬롯이 "public"이 아니면, InvalidAccessError를 던집니다.

   2. keyAlgorithm을 key의 [[algorithm]] 내부 슬롯으로 설정합니다.

   3. data를 [RFC5280]에 정의된 SubjectPublicKeyInfo ASN.1 구조의 인스턴스로 설정하며 다음 속성을 갖도록 합니다:

      • algorithm 필드를 다음 속성을 가진 AlgorithmIdentifier ASN.1 유형으로 설정합니다:

        • keyAlgorithm의 name 멤버가 "ML-DSA-44"인 경우:

          algorithm 객체 식별자를 id-ml-dsa-44 (2.16.840.1.101.3.4.3.17) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "ML-DSA-65"인 경우:

          algorithm 객체 식별자를 id-ml-dsa-65 (2.16.840.1.101.3.4.3.18) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "ML-DSA-87"인 경우:

          algorithm 객체 식별자를 id-ml-dsa-87 (2.16.840.1.101.3.4.3.19) OID로 설정합니다.

          그렇지 않은 경우:

          NotSupportedError를 던집니다.

      • subjectPublicKey 필드를 keyData로 설정합니다.

   4. result를 data를 DER 인코딩한 결과로 설정합니다.

   format이 "pkcs8"인 경우:

   1. key의 [[type]] 내부 슬롯이 "private"이 아니면, InvalidAccessError를 던집니다.

   2. keyAlgorithm을 key의 [[algorithm]] 내부 슬롯으로 설정합니다.

   3. data를 [RFC5208]에 정의된 PrivateKeyInfo ASN.1 구조의 인스턴스로 설정하며 다음 속성을 갖도록 합니다:

      • version 필드를 0으로 설정합니다.

      • privateKeyAlgorithm 필드를 다음 속성을 가진 PrivateKeyAlgorithmIdentifier ASN.1 유형으로 설정합니다:

        • keyAlgorithm의 name 멤버가 "ML-DSA-44"인 경우:

          algorithm 객체 식별자를 id-ml-dsa-44 (2.16.840.1.101.3.4.3.17) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "ML-DSA-65"인 경우:

          algorithm 객체 식별자를 id-ml-dsa-65 (2.16.840.1.101.3.4.3.18) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "ML-DSA-87"인 경우:

          algorithm 객체 식별자를 id-ml-dsa-87 (2.16.840.1.101.3.4.3.19) OID로 설정합니다.

          그렇지 않은 경우:

          NotSupportedError를 던집니다.

      • privateKey 필드를 다음과 같이 설정합니다:

        • keyAlgorithm의 name 멤버가 "ML-DSA-44"인 경우:

          privateKey 필드를 key의 [[handle]] 내부 슬롯이 나타내는 ML-DSA 개인 키 시드를 seed-only 형식으로 나타내는 ML-DSA-44-PrivateKey ASN.1 유형을 DER 인코딩한 결과로 설정합니다 (OCTET STRING의 암시적 인코딩과 함께 컨텍스트별 [0] 기본 태그 사용).

          keyAlgorithm의 name 멤버가 "ML-DSA-65"인 경우:

          privateKey 필드를 key의 [[handle]] 내부 슬롯이 나타내는 ML-DSA 개인 키 시드를 seed-only 형식으로 나타내는 ML-DSA-65-PrivateKey ASN.1 유형을 DER 인코딩한 결과로 설정합니다 (OCTET STRING의 암시적 인코딩과 함께 컨텍스트별 [0] 기본 태그 사용).

          keyAlgorithm의 name 멤버가 "ML-DSA-87"인 경우:

          privateKey 필드를 key의 [[handle]] 내부 슬롯이 나타내는 ML-DSA 개인 키 시드를 seed-only 형식으로 나타내는 ML-DSA-87-PrivateKey ASN.1 유형을 DER 인코딩한 결과로 설정합니다 (OCTET STRING의 암시적 인코딩과 함께 컨텍스트별 [0] 기본 태그 사용).

          그렇지 않은 경우:

          NotSupportedError를 던집니다.

   4. result를 data를 DER 인코딩한 결과로 설정합니다.

   format이 "raw-public"인 경우:

   1. key의 [[type]] 내부 슬롯이 "public"이 아니면, InvalidAccessError를 던집니다.

   2. data를 key의 [[handle]] 내부 슬롯이 나타내는 ML-DSA 공개 키를 포함하는 바이트 시퀀스로 설정합니다.

   3. result를 data로 설정합니다.

   format이 "raw-seed"인 경우:

   1. key의 [[type]] 내부 슬롯이 "private"이 아니면, InvalidAccessError를 던집니다.

   2. data를 key의 [[handle]] 내부 슬롯이 나타내는 키의 ξ 시드 변수를 포함하는 바이트 시퀀스로 설정합니다.

      참고

      ξ 시드 변수는 [FIPS-204]의 섹션 5.1에 설명된 대로 ML-DSA.KeyGen 함수에서 샘플링되었습니다.

   3. result를 data로 설정합니다.

   format이 "jwk"인 경우:

   1. jwk를 새로운 JsonWebKey 사전으로 설정합니다.

   2. keyAlgorithm을 key의 [[algorithm]] 내부 슬롯으로 설정합니다.

   3. jwk의 kty 속성을 "AKP"로 설정합니다.

   4. jwk의 alg 속성을 keyAlgorithm의 name 멤버로 설정합니다.

   5. jwk의 pub 속성을 key의 [[handle]] 내부 슬롯에 대응하는 base64url 인코딩 공개 키로 설정합니다.

   6. key의 [[type]] 내부 슬롯이 "private"인 경우:

      jwk의 priv 속성을 key의 [[handle]] 내부 슬롯이 나타내는 base64url 인코딩 시드로 설정합니다.

   7. jwk의 key_ops 속성을 key의 usages 속성으로 설정합니다.

   8. jwk의 ext 속성을 key의 [[extractable]] 내부 슬롯으로 설정합니다.

   9. result를 jwk로 설정합니다.

   그렇지 않은 경우:

   NotSupportedError를 던집니다.

4. result를 반환합니다.

1. normalizedAlgorithm의 context 멤버가 존재하고 길이가 255 바이트보다 크면, OperationError를 던집니다.

2. key의 [[type]] 내부 슬롯이 "private"이 아니면, InvalidAccessError를 던집니다.

3. context를 normalizedAlgorithm의 context 멤버로 설정하거나, normalizedAlgorithm의 context 멤버가 존재하지 않는 경우 빈 옥텟 문자열로 설정합니다.

4. result를 [FIPS-205]의 섹션 10.2.1에 명시된 slh_sign 서명 알고리즘을 수행한 결과로 설정합니다. 이때 normalizedAlgorithm의 name 멤버가 나타내는 매개변수 집합을 사용하고, key와 연결된 SLH-DSA 개인 키를 SK로, message를 M으로, context를 ctx로 사용합니다.

5. slh_sign 알고리즘이 오류를 반환한 경우 OperationError를 반환합니다.

6. result를 반환합니다.

1. key의 [[type]] 내부 슬롯이 "public"이 아니면, InvalidAccessError를 던집니다.

2. context를 normalizedAlgorithm의 context 멤버로 설정하거나, normalizedAlgorithm의 context 멤버가 존재하지 않는 경우 빈 옥텟 문자열로 설정합니다.

3. result를 [FIPS-205]의 섹션 10.3에 명시된 slh_verify 검증 알고리즘을 수행한 결과로 설정합니다. 이때 normalizedAlgorithm의 name 멤버가 나타내는 매개변수 집합을 사용하고, key와 연결된 SLH-DSA 공개 키를 PK로, message를 M으로, signature를 SIG로, context를 ctx로 사용합니다.

4. slh_verify 알고리즘이 오류를 반환한 경우 OperationError를 반환합니다.

5. result를 반환합니다.

1. usages에 "sign" 또는 "verify" 중 하나가 아닌 항목이 포함되어 있으면, SyntaxError를 던집니다.

2. [FIPS-205]의 섹션 10.1에 설명된 대로, normalizedAlgorithm의 name 멤버가 나타내는 매개변수 집합을 사용하여 SLH-DSA 키 쌍을 생성합니다.

3. 키 생성 단계가 실패하면, OperationError를 던집니다.

4. algorithm을 새로운 KeyAlgorithm 객체로 설정합니다.

5. algorithm의 name 속성을 normalizedAlgorithm의 name 속성으로 설정합니다.

6. publicKey를 생성된 키 쌍의 공개 키를 나타내는 새로운 CryptoKey로 설정합니다.

7. publicKey의 [[type]] 내부 슬롯을 "public"으로 설정합니다.

8. publicKey의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

9. publicKey의 [[extractable]] 내부 슬롯을 true로 설정합니다.

10. publicKey의 [[usages]] 내부 슬롯을 usages와 [ "verify" ]의 용도 교집합으로 설정합니다.

11. privateKey를 생성된 키 쌍의 개인 키를 나타내는 새로운 CryptoKey로 설정합니다.

12. privateKey의 [[type]] 내부 슬롯을 "private"으로 설정합니다.

13. privateKey의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

14. privateKey의 [[extractable]] 내부 슬롯을 extractable로 설정합니다.

15. privateKey의 [[usages]] 내부 슬롯을 usages와 [ "sign" ]의 용도 교집합으로 설정합니다.

16. result를 새로운 CryptoKeyPair 사전으로 설정합니다.

17. result의 publicKey 속성을 publicKey로 설정합니다.

18. result의 privateKey 속성을 privateKey로 설정합니다.

19. result를 반환합니다.

1. keyData를 가져올 키 데이터로 설정합니다.

2. format이 "spki"인 경우:

   1. usages에 "verify"가 아닌 항목이 포함되어 있으면, SyntaxError를 던집니다.

   2. spki를 keyData에 대해 subjectPublicKeyInfo 파싱 알고리즘을 실행한 결과로 설정합니다.

   3. 파싱 중 오류가 발생하면, DataError를 던집니다.

   4. normalizedAlgorithm의 name 멤버가 "SLH-DSA-SHA2-128s"인 경우:

      expectedOid를 id-slh-dsa-sha2-128s (2.16.840.1.101.3.4.3.20)로 설정합니다.

      normalizedAlgorithm의 name 멤버가 "SLH-DSA-SHA2-128f"인 경우:

      expectedOid를 id-slh-dsa-sha2-128f (2.16.840.1.101.3.4.3.21)로 설정합니다.

      normalizedAlgorithm의 name 멤버가 "SLH-DSA-SHA2-192s"인 경우:

      expectedOid를 id-slh-dsa-sha2-192s (2.16.840.1.101.3.4.3.22)로 설정합니다.

      normalizedAlgorithm의 name 멤버가 "SLH-DSA-SHA2-192f"인 경우:

      expectedOid를 id-slh-dsa-sha2-192f (2.16.840.1.101.3.4.3.23)로 설정합니다.

      normalizedAlgorithm의 name 멤버가 "SLH-DSA-SHA2-256s"인 경우:

      expectedOid를 id-slh-dsa-sha2-256s (2.16.840.1.101.3.4.3.24)로 설정합니다.

      normalizedAlgorithm의 name 멤버가 "SLH-DSA-SHA2-256f"인 경우:

      expectedOid를 id-slh-dsa-sha2-256f (2.16.840.1.101.3.4.3.25)로 설정합니다.

      normalizedAlgorithm의 name 멤버가 "SLH-DSA-SHAKE-128s"인 경우:

      expectedOid를 id-slh-dsa-shake-128s (2.16.840.1.101.3.4.3.26)로 설정합니다.

      normalizedAlgorithm의 name 멤버가 "SLH-DSA-SHAKE-128f"인 경우:

      expectedOid를 id-slh-dsa-shake-128f (2.16.840.1.101.3.4.3.27)로 설정합니다.

      normalizedAlgorithm의 name 멤버가 "SLH-DSA-SHAKE-192s"인 경우:

      expectedOid를 id-slh-dsa-shake-192s (2.16.840.1.101.3.4.3.28)로 설정합니다.

      normalizedAlgorithm의 name 멤버가 "SLH-DSA-SHAKE-192f"인 경우:

      expectedOid를 id-slh-dsa-shake-192f (2.16.840.1.101.3.4.3.29)로 설정합니다.

      normalizedAlgorithm의 name 멤버가 "SLH-DSA-SHAKE-256s"인 경우:

      expectedOid를 id-slh-dsa-shake-256s (2.16.840.1.101.3.4.3.30)로 설정합니다.

      normalizedAlgorithm의 name 멤버가 "SLH-DSA-SHAKE-256f"인 경우:

      expectedOid를 id-slh-dsa-shake-256f (2.16.840.1.101.3.4.3.31)로 설정합니다.

      그렇지 않은 경우:

      NotSupportedError를 던집니다.

   5. spki의 algorithm AlgorithmIdentifier 필드의 algorithm 객체 식별자 필드가 expectedOid와 같지 않으면, DataError를 던집니다.

   6. spki의 algorithm AlgorithmIdentifier 필드에 parameters 필드가 존재하면, DataError를 던집니다.

   7. publicKey를 spki의 subjectPublicKey 필드가 식별하는 SLH-DSA 공개 키로 설정합니다.

   8. key를 publicKey를 나타내는 새로운 CryptoKey로 설정합니다.

   9. key의 [[type]] 내부 슬롯을 "public"으로 설정합니다.

   10. algorithm을 새로운 KeyAlgorithm으로 설정합니다.

   11. algorithm의 name 속성을 normalizedAlgorithm의 name 속성으로 설정합니다.

   12. key의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

   format이 "pkcs8"인 경우:

   1. usages에 "sign"이 아닌 항목이 포함되어 있으면, SyntaxError를 던집니다.

   2. privateKeyInfo를 keyData에 대해 privateKeyInfo 파싱 알고리즘을 실행한 결과로 설정합니다.

   3. 파싱 중 오류가 발생하면, DataError를 던집니다.

   4. normalizedAlgorithm의 name 멤버가 "SLH-DSA-SHA2-128s"인 경우:

      expectedOid를 id-slh-dsa-sha2-128s (2.16.840.1.101.3.4.3.20)로 설정합니다.

      normalizedAlgorithm의 name 멤버가 "SLH-DSA-SHA2-128f"인 경우:

      expectedOid를 id-slh-dsa-sha2-128f (2.16.840.1.101.3.4.3.21)로 설정합니다.

      normalizedAlgorithm의 name 멤버가 "SLH-DSA-SHA2-192s"인 경우:

      expectedOid를 id-slh-dsa-sha2-192s (2.16.840.1.101.3.4.3.22)로 설정합니다.

      normalizedAlgorithm의 name 멤버가 "SLH-DSA-SHA2-192f"인 경우:

      expectedOid를 id-slh-dsa-sha2-192f (2.16.840.1.101.3.4.3.23)로 설정합니다.

      normalizedAlgorithm의 name 멤버가 "SLH-DSA-SHA2-256s"인 경우:

      expectedOid를 id-slh-dsa-sha2-256s (2.16.840.1.101.3.4.3.24)로 설정합니다.

      normalizedAlgorithm의 name 멤버가 "SLH-DSA-SHA2-256f"인 경우:

      expectedOid를 id-slh-dsa-sha2-256f (2.16.840.1.101.3.4.3.25)로 설정합니다.

      normalizedAlgorithm의 name 멤버가 "SLH-DSA-SHAKE-128s"인 경우:

      expectedOid를 id-slh-dsa-shake-128s (2.16.840.1.101.3.4.3.26)로 설정합니다.

      normalizedAlgorithm의 name 멤버가 "SLH-DSA-SHAKE-128f"인 경우:

      expectedOid를 id-slh-dsa-shake-128f (2.16.840.1.101.3.4.3.27)로 설정합니다.

      normalizedAlgorithm의 name 멤버가 "SLH-DSA-SHAKE-192s"인 경우:

      expectedOid를 id-slh-dsa-shake-192s (2.16.840.1.101.3.4.3.28)로 설정합니다.

      normalizedAlgorithm의 name 멤버가 "SLH-DSA-SHAKE-192f"인 경우:

      expectedOid를 id-slh-dsa-shake-192f (2.16.840.1.101.3.4.3.29)로 설정합니다.

      normalizedAlgorithm의 name 멤버가 "SLH-DSA-SHAKE-256s"인 경우:

      expectedOid를 id-slh-dsa-shake-256s (2.16.840.1.101.3.4.3.30)로 설정합니다.

      normalizedAlgorithm의 name 멤버가 "SLH-DSA-SHAKE-256f"인 경우:

      expectedOid를 id-slh-dsa-shake-256f (2.16.840.1.101.3.4.3.31)로 설정합니다.

      그렇지 않은 경우:

      NotSupportedError를 던집니다.

   5. privateKeyInfo의 privateKeyAlgorithm PrivateKeyAlgorithm 필드의 algorithm 객체 식별자 필드가 expectedOid와 같지 않으면, DataError를 던집니다.

   6. privateKeyInfo의 privateKeyAlgorithm PrivateKeyAlgorithmIdentifier 필드에 parameters 필드가 존재하면, DataError를 던집니다.

   7. slhDsaPrivateKey를 ASN.1 구조 파싱 알고리즘을 수행한 결과로 설정합니다. 이때 data에는 privateKeyInfo의 privateKey 필드를, structure에는 OCTET STRING을 사용하고, exactData는 true로 설정합니다.

   8. 파싱 중 오류가 발생하면, DataError를 던집니다.

   9. key를 slhDsaPrivateKey가 식별하는 SLH-DSA 개인 키를 나타내는 새로운 CryptoKey로 설정합니다.

   10. key의 [[type]] 내부 슬롯을 "private"으로 설정합니다.

   11. algorithm을 새로운 KeyAlgorithm으로 설정합니다.

   12. algorithm의 name 속성을 normalizedAlgorithm의 name 속성으로 설정합니다.

   13. key의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

   format이 "raw-public"인 경우:

   1. usages에 "verify"가 아닌 항목이 포함되어 있으면, SyntaxError를 던집니다.

   2. algorithm을 새로운 KeyAlgorithm 객체로 설정합니다.

   3. algorithm의 name 속성을 normalizedAlgorithm의 name 속성으로 설정합니다.

   4. keyData의 길이가 [FIPS-205]의 표 2에서 normalizedAlgorithm의 name 멤버가 나타내는 매개변수 집합에 대해 명시한 pk length와 같지 않으면, DataError를 던집니다.

   5. key를 keyData에 제공된 키 데이터를 나타내는 새로운 CryptoKey로 설정합니다.

   6. key의 [[type]] 내부 슬롯을 "public"으로 설정합니다.

   7. key의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

   format이 "raw-private"인 경우:

   1. usages에 "sign"이 아닌 항목이 포함되어 있으면, SyntaxError를 던집니다.

   2. keyData의 길이가 [FIPS-205]의 표 2에서 normalizedAlgorithm의 name 멤버가 나타내는 매개변수 집합에 대해 명시한 pk length의 2배와 같지 않으면, DataError를 던집니다.

   3. key를 keyData에 제공된 키 데이터를 나타내는 새로운 CryptoKey로 설정합니다.

   4. key의 [[type]] 내부 슬롯을 "private"으로 설정합니다.

   5. algorithm을 새로운 KeyAlgorithm으로 설정합니다.

   6. algorithm의 name 속성을 normalizedAlgorithm의 name 속성으로 설정합니다.

   7. key의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

   format이 "jwk"인 경우:

   1. keyData가 JsonWebKey 사전인 경우:

      jwk를 keyData와 같게 설정합니다.

      그렇지 않은 경우:

      DataError를 던집니다.

   2. priv 필드가 존재하고 usages에 "sign"이 아닌 항목이 포함되어 있거나, priv 필드가 존재하지 않고 usages에 "verify"가 아닌 항목이 포함되어 있으면, SyntaxError를 던집니다.

   3. jwk의 kty 필드가 "AKP"가 아니면, DataError를 던집니다.

   4. jwk의 alg 필드가 normalizedAlgorithm의 name 멤버와 같지 않으면, DataError를 던집니다.

   5. usages가 비어 있지 않고 jwk의 use 필드가 존재하며 "sig"와 같지 않으면, DataError를 던집니다.

   6. jwk의 key_ops 필드가 존재하며 JSON Web Key [JWK]의 요구사항에 따라 유효하지 않거나, 지정된 모든 usages 값을 포함하지 않으면, DataError를 던집니다.

   7. jwk의 ext 필드가 존재하고 값이 false이며 extractable이 true이면, DataError를 던집니다.

   8. jwk의 priv 필드가 존재하는 경우:

      1. jwk의 priv 속성이 SLH-DSA 개인 키를 나타내는 유효한 base64url 인코딩 값을 포함하지 않으면, DataError를 던집니다.

      2. key를 jwk의 priv 속성을 base64url로 인코딩된 개인 키로 해석하여 식별되는 SLH-DSA 개인 키를 나타내는 새로운 CryptoKey 객체로 설정합니다.

      3. key의 [[type]] 내부 슬롯을 "private"으로 설정합니다.

      4. jwk의 pub 속성이 key에 대응하는 SLH-DSA 공개 키를 나타내는 base64url 인코딩 공개 키를 포함하지 않으면, DataError를 던집니다.

      그렇지 않은 경우:

      1. jwk의 pub 속성이 SLH-DSA 공개 키를 나타내는 유효한 base64url 인코딩 공개 키를 포함하지 않으면, DataError를 던집니다.

      2. key를 jwk의 pub 속성을 base64url로 인코딩된 공개 키로 해석하여 식별되는 SLH-DSA 공개 키를 나타내는 새로운 CryptoKey 객체로 설정합니다.

      3. key의 [[type]] 내부 슬롯을 "public"으로 설정합니다.

   9. algorithm을 새로운 KeyAlgorithm 객체의 인스턴스로 설정합니다.

   10. algorithm의 name 속성을 normalizedAlgorithm의 name 멤버로 설정합니다.

   11. key의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

   그렇지 않은 경우:

   NotSupportedError를 던집니다.

3. key를 반환합니다.

1. key를 내보낼 CryptoKey로 설정합니다.

2. key의 [[handle]] 내부 슬롯이 나타내는 기본 암호화 키 재료에 접근할 수 없으면, OperationError를 던집니다.

3. format이 "spki"인 경우:

   1. key의 [[type]] 내부 슬롯이 "public"이 아니면, InvalidAccessError를 던집니다.

   2. keyAlgorithm을 key의 [[algorithm]] 내부 슬롯으로 설정합니다.

   3. data를 [RFC5280]에 정의된 SubjectPublicKeyInfo ASN.1 구조의 인스턴스로 설정하며 다음 속성을 갖도록 합니다:

      • algorithm 필드를 다음 속성을 가진 AlgorithmIdentifier ASN.1 유형으로 설정합니다:

        • keyAlgorithm의 name 멤버가 "SLH-DSA-SHA2-128s"인 경우:

          algorithm 객체 식별자를 id-slh-dsa-sha2-128s (2.16.840.1.101.3.4.3.20) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "SLH-DSA-SHA2-128f"인 경우:

          algorithm 객체 식별자를 id-slh-dsa-sha2-128f (2.16.840.1.101.3.4.3.21) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "SLH-DSA-SHA2-192s"인 경우:

          algorithm 객체 식별자를 id-slh-dsa-sha2-192s (2.16.840.1.101.3.4.3.22) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "SLH-DSA-SHA2-192f"인 경우:

          algorithm 객체 식별자를 id-slh-dsa-sha2-192f (2.16.840.1.101.3.4.3.23) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "SLH-DSA-SHA2-256s"인 경우:

          algorithm 객체 식별자를 id-slh-dsa-sha2-256s (2.16.840.1.101.3.4.3.24) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "SLH-DSA-SHA2-256f"인 경우:

          algorithm 객체 식별자를 id-slh-dsa-sha2-256f (2.16.840.1.101.3.4.3.25) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "SLH-DSA-SHAKE-128s"인 경우:

          algorithm 객체 식별자를 id-slh-dsa-shake-128s (2.16.840.1.101.3.4.3.26) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "SLH-DSA-SHAKE-128f"인 경우:

          algorithm 객체 식별자를 id-slh-dsa-shake-128f (2.16.840.1.101.3.4.3.27) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "SLH-DSA-SHAKE-192s"인 경우:

          algorithm 객체 식별자를 id-slh-dsa-shake-192s (2.16.840.1.101.3.4.3.28) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "SLH-DSA-SHAKE-192f"인 경우:

          algorithm 객체 식별자를 id-slh-dsa-shake-192f (2.16.840.1.101.3.4.3.29) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "SLH-DSA-SHAKE-256s"인 경우:

          algorithm 객체 식별자를 id-slh-dsa-shake-256s (2.16.840.1.101.3.4.3.30) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "SLH-DSA-SHAKE-256f"인 경우:

          algorithm 객체 식별자를 id-slh-dsa-shake-256f (2.16.840.1.101.3.4.3.31) OID로 설정합니다.

          그렇지 않은 경우:

          NotSupportedError를 던집니다.

      • subjectPublicKey 필드를 keyData로 설정합니다.

   4. result를 data를 DER 인코딩한 결과로 설정합니다.

   format이 "pkcs8"인 경우:

   1. key의 [[type]] 내부 슬롯이 "private"이 아니면, InvalidAccessError를 던집니다.

   2. keyAlgorithm을 key의 [[algorithm]] 내부 슬롯으로 설정합니다.

   3. data를 [RFC5208]에 정의된 PrivateKeyInfo ASN.1 구조의 인스턴스로 설정하며 다음 속성을 갖도록 합니다:

      • version 필드를 0으로 설정합니다.

      • privateKeyAlgorithm 필드를 다음 속성을 가진 PrivateKeyAlgorithmIdentifier ASN.1 유형으로 설정합니다:

        • keyAlgorithm의 name 멤버가 "SLH-DSA-SHA2-128s"인 경우:

          algorithm 객체 식별자를 id-slh-dsa-sha2-128s (2.16.840.1.101.3.4.3.20) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "SLH-DSA-SHA2-128f"인 경우:

          algorithm 객체 식별자를 id-slh-dsa-sha2-128f (2.16.840.1.101.3.4.3.21) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "SLH-DSA-SHA2-192s"인 경우:

          algorithm 객체 식별자를 id-slh-dsa-sha2-192s (2.16.840.1.101.3.4.3.22) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "SLH-DSA-SHA2-192f"인 경우:

          algorithm 객체 식별자를 id-slh-dsa-sha2-192f (2.16.840.1.101.3.4.3.23) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "SLH-DSA-SHA2-256s"인 경우:

          algorithm 객체 식별자를 id-slh-dsa-sha2-256s (2.16.840.1.101.3.4.3.24) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "SLH-DSA-SHA2-256f"인 경우:

          algorithm 객체 식별자를 id-slh-dsa-sha2-256f (2.16.840.1.101.3.4.3.25) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "SLH-DSA-SHAKE-128s"인 경우:

          algorithm 객체 식별자를 id-slh-dsa-shake-128s (2.16.840.1.101.3.4.3.26) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "SLH-DSA-SHAKE-128f"인 경우:

          algorithm 객체 식별자를 id-slh-dsa-shake-128f (2.16.840.1.101.3.4.3.27) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "SLH-DSA-SHAKE-192s"인 경우:

          algorithm 객체 식별자를 id-slh-dsa-shake-192s (2.16.840.1.101.3.4.3.28) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "SLH-DSA-SHAKE-192f"인 경우:

          algorithm 객체 식별자를 id-slh-dsa-shake-192f (2.16.840.1.101.3.4.3.29) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "SLH-DSA-SHAKE-256s"인 경우:

          algorithm 객체 식별자를 id-slh-dsa-shake-256s (2.16.840.1.101.3.4.3.30) OID로 설정합니다.

          keyAlgorithm의 name 멤버가 "SLH-DSA-SHAKE-256f"인 경우:

          algorithm 객체 식별자를 id-slh-dsa-shake-256f (2.16.840.1.101.3.4.3.31) OID로 설정합니다.

          그렇지 않은 경우:

          NotSupportedError를 던집니다.

      • privateKey 필드를 key의 [[handle]] 내부 슬롯이 나타내는 SLH-DSA 개인 키를 나타내는 OCTET STRING ASN.1 유형을 DER 인코딩한 결과로 설정합니다.

   4. result를 data를 DER 인코딩한 결과로 설정합니다.

   format이 "raw-public"인 경우:

   1. key의 [[type]] 내부 슬롯이 "public"이 아니면, InvalidAccessError를 던집니다.

   2. data를 key의 [[handle]] 내부 슬롯이 나타내는 SLH-DSA 공개 키를 포함하는 바이트 시퀀스로 설정합니다.

   3. result를 data로 설정합니다.

   format이 "raw-private"인 경우:

   1. key의 [[type]] 내부 슬롯이 "private"이 아니면, InvalidAccessError를 던집니다.

   2. data를 key의 [[handle]] 내부 슬롯이 나타내는 SLH-DSA 개인 키를 포함하는 바이트 시퀀스로 설정합니다.

   3. result를 data로 설정합니다.

   format이 "jwk"인 경우:

   1. jwk를 새로운 JsonWebKey 사전으로 설정합니다.

   2. keyAlgorithm을 key의 [[algorithm]] 내부 슬롯으로 설정합니다.

   3. jwk의 kty 속성을 "AKP"로 설정합니다.

   4. jwk의 alg 속성을 keyAlgorithm의 name 멤버로 설정합니다.

   5. jwk의 pub 속성을 key의 [[handle]] 내부 슬롯에 대응하는 base64url 인코딩 공개 키로 설정합니다.

   6. key의 [[type]] 내부 슬롯이 "private"인 경우:

      jwk의 priv 속성을 key의 [[handle]] 내부 슬롯이 나타내는 base64url 인코딩 개인 키로 설정합니다.

   7. jwk의 key_ops 속성을 key의 usages 속성으로 설정합니다.

   8. jwk의 ext 속성을 key의 [[extractable]] 내부 슬롯으로 설정합니다.

   9. result를 jwk로 설정합니다.

   그렇지 않은 경우:

   NotSupportedError를 던집니다.

4. result를 반환합니다.

1. normalizedAlgorithm의 iv 멤버의 길이가 15 바이트보다 크면, OperationError를 던집니다.

2. normalizedAlgorithm의 tagLength 멤버가 존재하지 않는 경우:

   tagLength를 128로 설정합니다.

   normalizedAlgorithm의 tagLength 멤버가 64, 96 또는 128 중 하나인 경우:

   tagLength를 normalizedAlgorithm의 tagLength 멤버와 같게 설정합니다.

   그렇지 않은 경우:

   OperationError를 던집니다.

3. additionalData를 normalizedAlgorithm의 additionalData 멤버가 존재하면 해당 멤버로 설정하고, 그렇지 않으면 빈 옥텟 문자열로 설정합니다.

4. C를 [RFC7253]의 섹션 4.2에 설명된 OCB-ENCRYPT 함수를 수행하여 얻은 출력으로 설정합니다. 이때 AES를 블록 암호로 사용하고, key의 [[handle]] 내부 슬롯이 나타내는 키를 K 입력 매개변수로, normalizedAlgorithm의 iv 멤버를 N 입력 매개변수로, additionalData를 A 입력 매개변수로, plaintext를 P 입력 매개변수로, 그리고 tagLength를 TAGLEN 전역 매개변수로 사용합니다.

5. C를 반환합니다.

1. normalizedAlgorithm의 iv 멤버의 길이가 15 바이트보다 크면, OperationError를 던집니다.

2. normalizedAlgorithm의 tagLength 멤버가 존재하지 않는 경우:

   tagLength를 128로 설정합니다.

   normalizedAlgorithm의 tagLength 멤버가 64, 96 또는 128 중 하나인 경우:

   tagLength를 normalizedAlgorithm의 tagLength 멤버와 같게 설정합니다.

   그렇지 않은 경우:

   OperationError를 던집니다.

3. ciphertext의 길이가 tagLength 비트보다 작으면, OperationError를 던집니다.

4. additionalData를 normalizedAlgorithm의 additionalData 멤버가 존재하면 해당 멤버로 설정하고, 그렇지 않으면 빈 옥텟 문자열로 설정합니다.

5. [RFC7253]의 섹션 4.3에 설명된 OCB-DECRYPT 함수를 수행합니다. 이때 AES를 블록 암호로 사용하고, key의 [[handle]] 내부 슬롯이 나타내는 키를 K 입력 매개변수로, normalizedAlgorithm의 iv 멤버를 N 입력 매개변수로, additionalData를 A 입력 매개변수로, ciphertext를 C 입력 매개변수로, 그리고 tagLength를 TAGLEN 전역 매개변수로 사용합니다.

   알고리즘의 결과가 인증 실패를 나타내는 "INVALID"인 경우:

   OperationError를 던집니다.

   그렇지 않은 경우:

   plaintext를 OCB-DECRYPT의 출력 P로 설정합니다.

6. plaintext를 반환합니다.

1. usages에 "encrypt", "decrypt", "wrapKey" 또는 "unwrapKey" 중 하나가 아닌 항목이 포함되어 있으면, SyntaxError를 던집니다.

2. normalizedAlgorithm의 length 멤버가 128, 192 또는 256 중 하나와 같지 않으면, OperationError를 던집니다.

3. normalizedAlgorithm의 length 멤버와 동일한 길이의 AES 키를 생성합니다.

4. 키 생성 단계가 실패하면, OperationError를 던집니다.

5. key를 생성된 AES 키를 나타내는 새로운 CryptoKey 객체로 설정합니다.

6. key의 [[type]] 내부 슬롯을 "secret"으로 설정합니다.

7. algorithm을 새로운 AesKeyAlgorithm으로 설정합니다.

8. algorithm의 name 속성을 "AES-OCB"로 설정합니다.

9. algorithm의 length 속성을 normalizedAlgorithm의 length 멤버와 같게 설정합니다.

10. key의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

11. key의 [[extractable]] 내부 슬롯을 extractable로 설정합니다.

12. key의 [[usages]] 내부 슬롯을 usages의 정규화된 값으로 설정합니다.

13. key를 반환합니다.

1. keyData를 가져올 키 데이터로 설정합니다.

2. usages에 "encrypt", "decrypt", "wrapKey" 또는 "unwrapKey" 중 하나가 아닌 항목이 포함되어 있으면, SyntaxError를 던집니다.

3. format이 "raw-secret"인 경우:

   1. data를 keyData로 설정합니다.

   2. data의 비트 단위 길이가 128, 192 또는 256이 아니면 DataError를 던집니다.

   format이 "jwk"인 경우:

   1. keyData가 JsonWebKey 사전인 경우:

      jwk를 keyData와 같게 설정합니다.

      그렇지 않은 경우:

      DataError를 던집니다.

   2. jwk의 kty 필드가 "oct"가 아니면, DataError를 던집니다.

   3. jwk가 JSON Web Algorithms [JWA]의 섹션 6.4 요구사항을 충족하지 않으면, DataError를 던집니다.

   4. data를 jwk의 k 필드를 디코딩하여 얻은 바이트 시퀀스로 설정합니다.

   5. data의 길이가 128비트인 경우:

      jwk의 alg 필드가 존재하며 "A128OCB"가 아니면, DataError를 던집니다.

      data의 길이가 192비트인 경우:

      jwk의 alg 필드가 존재하며 "A192OCB"가 아니면, DataError를 던집니다.

      data의 길이가 256비트인 경우:

      jwk의 alg 필드가 존재하며 "A256OCB"가 아니면, DataError를 던집니다.

      그렇지 않은 경우:

      DataError를 던집니다.

   6. usages가 비어 있지 않고 jwk의 use 필드가 존재하며 "enc"가 아니면, DataError를 던집니다.

   7. jwk의 key_ops 필드가 존재하고, JSON Web Key [JWK]의 요구사항에 따라 유효하지 않거나 지정된 모든 usages 값을 포함하지 않으면, DataError를 던집니다.

   8. jwk의 ext 필드가 존재하고 값이 false이며 extractable이 true이면, DataError를 던집니다.

   그렇지 않은 경우:

   NotSupportedError를 던집니다.

4. key를 값이 data인 AES 키를 나타내는 새로운 CryptoKey 객체로 설정합니다.

5. key의 [[type]] 내부 슬롯을 "secret"으로 설정합니다.

6. algorithm을 새로운 AesKeyAlgorithm으로 설정합니다.

7. algorithm의 name 속성을 "AES-OCB"로 설정합니다.

8. algorithm의 length 속성을 data의 비트 단위 길이로 설정합니다.

9. key의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

10. key를 반환합니다.

1. key의 [[handle]] 내부 슬롯이 나타내는 기본 암호화 키 재료에 접근할 수 없으면, OperationError를 던집니다.

2. format이 "raw-secret"인 경우:

   1. data를 key의 [[handle]] 내부 슬롯이 나타내는 키의 원시 옥텟을 포함하는 바이트 시퀀스로 설정합니다.

   2. result를 data로 설정합니다.

   format이 "jwk"인 경우:

   1. jwk를 새로운 JsonWebKey 사전으로 설정합니다.

   2. jwk의 kty 속성을 문자열 "oct"로 설정합니다.

   3. jwk의 k 속성을 key의 [[handle]] 내부 슬롯이 나타내는 키의 원시 옥텟을 포함하고, JSON Web Algorithms [JWA]의 섹션 6.4에 따라 인코딩된 문자열로 설정합니다.

   4. key의 length 속성이 128인 경우:

      jwk의 alg 속성을 문자열 "A128OCB"로 설정합니다.

      key의 length 속성이 192인 경우:

      jwk의 alg 속성을 문자열 "A192OCB"로 설정합니다.

      key의 length 속성이 256인 경우:

      jwk의 alg 속성을 문자열 "A256OCB"로 설정합니다.

   5. jwk의 key_ops 속성을 key의 usages 속성과 같게 설정합니다.

   6. jwk의 ext 속성을 key의 [[extractable]] 내부 슬롯과 같게 설정합니다.

   7. result를 jwk로 설정합니다.

   그렇지 않은 경우:

   NotSupportedError를 던집니다.

3. result를 반환합니다.

1. normalizedDerivedKeyAlgorithm의 length 멤버가 128, 192 또는 256이 아니면, OperationError를 던집니다.

2. normalizedDerivedKeyAlgorithm의 length 멤버를 반환합니다.

1. normalizedAlgorithm의 iv 멤버의 길이가 12바이트가 아니면, OperationError를 던집니다.

2. normalizedAlgorithm의 tagLength 멤버가 존재하고 128이 아니면, OperationError를 던집니다.

3. additionalData를 normalizedAlgorithm의 additionalData 멤버가 존재하면 해당 멤버로 설정하고, 그렇지 않으면 빈 옥텟 문자열로 설정합니다.

4. ciphertext를 [RFC8439]의 섹션 2.8에 설명된 AEAD_CHACHA20_POLY1305 암호화 알고리즘을 수행하여 얻은 출력으로 설정합니다. 이때 key의 [[handle]] 내부 슬롯이 나타내는 키를 키 입력 매개변수로, normalizedAlgorithm의 iv 멤버를 nonce 입력 매개변수로, plaintext를 평문 입력 매개변수로, 그리고 additionalData를 추가 인증 데이터(AAD) 입력 매개변수로 사용합니다.

5. ciphertext를 반환합니다.

1. normalizedAlgorithm의 iv 멤버의 길이가 12바이트가 아니면, OperationError를 던집니다.

2. normalizedAlgorithm의 tagLength 멤버가 존재하고 128이 아니면, OperationError를 던집니다.

3. ciphertext의 길이가 128비트보다 작으면, OperationError를 던집니다.

4. additionalData를 normalizedAlgorithm의 additionalData 멤버가 존재하면 해당 멤버로 설정하고, 그렇지 않으면 빈 옥텟 문자열로 설정합니다.

5. [RFC8439]의 섹션 2.8에 설명된 AEAD_CHACHA20_POLY1305 복호화 알고리즘을 수행합니다. 이때 key의 [[handle]] 내부 슬롯이 나타내는 키를 키 입력 매개변수로, normalizedAlgorithm의 iv 멤버를 nonce 입력 매개변수로, ciphertext를 암호문 입력 매개변수로, 그리고 additionalData를 추가 인증 데이터(AAD) 입력 매개변수로 사용합니다.

   알고리즘의 결과가 인증 실패를 나타내는 경우:

   OperationError를 던집니다

   그렇지 않은 경우:

   plaintext를 결과 평문으로 설정합니다.

6. plaintext를 반환합니다.

1. usages에 "encrypt", "decrypt", "wrapKey" 또는 "unwrapKey" 중 하나가 아닌 항목이 포함되어 있으면, SyntaxError를 던집니다.

2. 256비트 키를 생성합니다.

3. 키 생성 단계가 실패하면, OperationError를 던집니다.

4. key를 생성된 키를 나타내는 새로운 CryptoKey 객체로 설정합니다.

5. key의 [[type]] 내부 슬롯을 "secret"으로 설정합니다.

6. algorithm을 새로운 KeyAlgorithm으로 설정합니다.

7. algorithm의 name 속성을 "ChaCha20-Poly1305"로 설정합니다.

8. key의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

9. key의 [[extractable]] 내부 슬롯을 extractable로 설정합니다.

10. key의 [[usages]] 내부 슬롯을 usages의 정규화된 값으로 설정합니다.

11. key를 반환합니다.

1. keyData를 가져올 키 데이터로 설정합니다.

2. usages에 "encrypt", "decrypt", "wrapKey" 또는 "unwrapKey" 중 하나가 아닌 항목이 포함되어 있으면, SyntaxError를 던집니다.

3. format이 "raw-secret"인 경우:

   1. data를 keyData로 설정합니다.

   2. data의 비트 단위 길이가 256이 아니면 DataError를 던집니다.

   format이 "jwk"인 경우:

   1. keyData가 JsonWebKey 사전인 경우:

      jwk를 keyData와 같게 설정합니다.

      그렇지 않은 경우:

      DataError를 던집니다.

   2. jwk의 kty 필드가 "oct"가 아니면, DataError를 던집니다.

   3. jwk가 JSON Web Algorithms [JWA]의 섹션 6.4 요구사항을 충족하지 않으면, DataError를 던집니다.

   4. data를 jwk의 k 필드를 디코딩하여 얻은 바이트 시퀀스로 설정합니다.

   5. jwk의 alg 필드가 존재하며 "C20P"가 아니면, DataError를 던집니다.

   6. usages가 비어 있지 않고 jwk의 use 필드가 존재하며 "enc"가 아니면, DataError를 던집니다.

   7. jwk의 key_ops 필드가 존재하고, JSON Web Key [JWK]의 요구사항에 따라 유효하지 않거나 지정된 모든 usages 값을 포함하지 않으면, DataError를 던집니다.

   8. jwk의 ext 필드가 존재하고 값이 false이며 extractable이 true이면, DataError를 던집니다.

   그렇지 않은 경우:

   NotSupportedError를 던집니다.

4. key를 값이 data인 키를 나타내는 새로운 CryptoKey 객체로 설정합니다.

5. key의 [[type]] 내부 슬롯을 "secret"으로 설정합니다.

6. algorithm을 새로운 KeyAlgorithm으로 설정합니다.

7. algorithm의 name 속성을 "ChaCha20-Poly1305"로 설정합니다.

8. key의 [[algorithm]] 내부 슬롯을 algorithm으로 설정합니다.

9. key를 반환합니다.

1. key의 [[handle]] 내부 슬롯이 나타내는 기본 암호화 키 재료에 접근할 수 없으면, OperationError를 던집니다.

2. format이 "raw-secret"인 경우:

   1. data를 key의 [[handle]] 내부 슬롯이 나타내는 키의 원시 옥텟을 포함하는 바이트 시퀀스로 설정합니다.

   2. result를 data로 설정합니다.

   format이 "jwk"인 경우:

   1. jwk를 새로운 JsonWebKey 사전으로 설정합니다.

   2. jwk의 kty 속성을 문자열 "oct"로 설정합니다.

   3. jwk의 k 속성을 key의 [[handle]] 내부 슬롯이 나타내는 키의 원시 옥텟을 포함하고, JSON Web Algorithms [JWA]의 섹션 6.4에 따라 인코딩된 문자열로 설정합니다.

   4. jwk의 alg 속성을 문자열 "C20P"로 설정합니다.

   5. jwk의 key_ops 속성을 key의 usages 속성과 같게 설정합니다.

   6. jwk의 ext 속성을 key의 [[extractable]] 내부 슬롯과 같게 설정합니다.

   7. result를 jwk로 설정합니다.

   그렇지 않은 경우:

   NotSupportedError를 던집니다.

3. result를 반환합니다.

1. 256을 반환합니다.

1. normalizedAlgorithm의 name 멤버가 "SHA3-256"과 대소문자를 구분하여 문자열이 일치하는 경우:

   result를 [FIPS-202]의 섹션 6.1에 정의된 SHA3-256 해시 함수를 수행한 결과로 설정하며, message를 입력 메시지 M으로 사용합니다.

   normalizedAlgorithm의 name 멤버가 "SHA3-384"과 대소문자를 구분하여 문자열이 일치하는 경우:

   result를 [FIPS-202]의 섹션 6.1에 정의된 SHA3-384 해시 함수를 수행한 결과로 설정하며, message를 입력 메시지 M으로 사용합니다.

   normalizedAlgorithm의 name 멤버가 "SHA3-512"과 대소문자를 구분하여 문자열이 일치하는 경우:

   result를 [FIPS-202]의 섹션 6.1에 정의된 SHA3-512 해시 함수를 수행한 결과로 설정하며, message를 입력 메시지 M으로 사용합니다.

2. 연산을 수행한 결과 오류가 발생하면, OperationError를 던집니다.

3. result를 반환합니다.

1. outputLength를 normalizedAlgorithm의 outputLength 멤버로 설정합니다.

2. functionName을 normalizedAlgorithm의 functionName 멤버가 존재하면 해당 멤버로 설정하고, 그렇지 않으면 빈 옥텟 문자열로 설정합니다.

3. customization을 normalizedAlgorithm의 customization 멤버가 존재하면 해당 멤버로 설정하고, 그렇지 않으면 빈 옥텟 문자열로 설정합니다.

4. normalizedAlgorithm의 name 멤버가 "cSHAKE128"과 대소문자를 구분하여 문자열이 일치하는 경우:

   result를 [NIST-SP800-185]의 섹션 3에 정의된 cSHAKE128 함수를 수행한 결과로 설정하며, message를 X 입력 매개변수로, outputLength를 L 입력 매개변수로, functionName을 N 입력 매개변수로, 그리고 customization을 S 입력 매개변수로 사용합니다.

   normalizedAlgorithm의 name 멤버가 "cSHAKE256"과 대소문자를 구분하여 문자열이 일치하는 경우:

   result를 [NIST-SP800-185]의 섹션 3에 정의된 cSHAKE256 함수를 수행한 결과로 설정하며, message를 X 입력 매개변수로, outputLength를 L 입력 매개변수로, functionName을 N 입력 매개변수로, 그리고 customization을 S 입력 매개변수로 사용합니다.

5. 연산을 수행한 결과 오류가 발생하면, OperationError를 던집니다.

6. result를 포함하는 바이트 시퀀스를 반환합니다.

1. outputLength를 normalizedAlgorithm의 outputLength 멤버로 설정합니다.

2. outputLength가 0이거나 8의 배수가 아니면, OperationError를 던집니다.

3. domainSeparation을 normalizedAlgorithm의 domainSeparation 멤버가 존재하면 해당 멤버로 설정하고, 그렇지 않으면 0x1F로 설정합니다.

4. domainSeparation이 0x01보다 작거나 0x7F보다 크면, OperationError를 던집니다.

5. normalizedAlgorithm의 name 멤버가 "TurboSHAKE128"과 대소문자를 구분하여 문자열이 일치하는 경우:

   result를 [RFC9861]의 섹션 2에 정의된 TurboSHAKE128 함수를 수행한 결과로 설정하며, message를 M 입력 매개변수로, domainSeparation을 D 입력 매개변수로, 그리고 outputLength를 8로 나눈 값을 L 입력 매개변수로 사용합니다.

   normalizedAlgorithm의 name 멤버가 "TurboSHAKE256"과 대소문자를 구분하여 문자열이 일치하는 경우:

   result를 [RFC9861]의 섹션 2에 정의된 TurboSHAKE256 함수를 수행한 결과로 설정하며, message를 M 입력 매개변수로, domainSeparation을 D 입력 매개변수로, 그리고 outputLength를 8로 나눈 값을 L 입력 매개변수로 사용합니다.

6. 연산을 수행한 결과 오류가 발생하면, OperationError를 던집니다.

7. result를 반환합니다.