객체다이제스트

정보 요약 개체

다음과 같이 Digest 객체를 사용할 수 있습니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
const crypto = require('crypto');
// create a SHA-512 digest object
const digest = crypto.createHash('sha512');
// update digest with data
digest.update('hello');
digest.update('world');
// get digest result
const result = digest.digest();
console.log(result);

// output result in hex and base64
console.log(result.toString('hex'));
console.log(result.toString('base64'));

위 코드에서는 crypto.createHash()메소드를 이용하여 SHA-512 다이제스트 연산 객체를 생성하는데, 이 update()메소드를 통해 요약할 데이터를 점진적으로 추가하고 digest()요약 결과를 얻을 수 있다.

상속관계

구성원 속성

size

정수, 현재 정보 다이제스트 알고리즘의 다이제스트 바이트 수를 쿼리합니다.

1
readonly Integer Digest.size;

멤버 함수

update

바이너리 다이제스트 정보 업데이트

1
Digest Digest.update(Buffer data);

호출 매개변수:

• data:Buffer, 바이너리 데이터 블록

결과 반환:

• Digest, 정보 요약 객체 자체를 반환합니다.

---

문자열 요약 정보 업데이트

1
2
Digest Digest.update(String data,
    String codec = "utf8");

호출 매개변수:

• data: 문자열, 문자열 데이터
• codec: 문자열, 인코딩 형식을 지정하며 허용되는 값은 "buffer", "hex", "base32", "base58", "base64", "utf8" 또는iconv모듈에서 지원하는 문자 세트

결과 반환:

• Digest, 정보 요약 객체 자체를 반환합니다.

---

digest

계산 및 반환 요약

1
Value Digest.digest(String codec = "buffer");

호출 매개변수:

• codec: 문자열, 인코딩 형식을 지정하며 허용되는 값은 "buffer", "hex", "base32", "base58", "base64", "utf8" 또는iconv모듈에서 지원하는 문자 세트

결과 반환:

• Value, 지정된 인코딩의 요약 표현을 반환합니다.

---

sign

서명 및 반환 요약

1
2
Buffer Digest.sign(PKey key,
    Object opts = {}) async;

호출 매개변수:

• key:PKey, 서명된 개인 키
• opts: 개체, 서명 옵션 지정

결과 반환:

• Buffer, 서명된 데이터를 반환합니다.

opts는 다음 매개변수를 지원합니다:

1
2
3
4
5
6
7
8
9
10
{
    alg: 0 指定签名的 hash 算法， 仅在 RSA 时有效， 缺省为 0. 支持算法: 0 = NONE,
    1 = MD5,
    2 = SHA1,
    3 = SHA224,
    4 = SHA256,
    5 = SHA384,
    6 = SHA512,
    7 = RIPEMD160
}

---

verify

서명이 일치하는지 확인

1
2
3
Boolean Digest.verify(PKey key,
    Buffer sign,
    Object opts = {}) async;

호출 매개변수:

• key:PKey, 서명을 확인하기 위한 공개 키
• sign:Buffer, 확인할 서명을 지정하세요.
• opts: 개체, 확인 옵션 지정

결과 반환:

• Boolean, 검증된 결과를 반환합니다.

opts는 다음 매개변수를 지원합니다:

1
2
3
4
5
6
7
8
9
10
{
    alg: 0 指定签名的 hash 算法， 仅在 RSA 时有效， 缺省为 0. 支持算法: 0 = NONE,
    1 = MD5,
    2 = SHA1,
    3 = SHA224,
    4 = SHA256,
    5 = SHA384,
    6 = SHA512,
    7 = RIPEMD160
}

---

toString

객체의 문자열 표현을 반환하며 일반적으로 "[Native Object]"를 반환하며 객체 자체의 특성에 따라 다시 구현될 수 있습니다.

1
String Digest.toString();

결과 반환:

• String, 객체의 문자열 표현을 반환합니다.

---

toJSON

객체의 JSON 형식 표현을 반환하며 일반적으로 객체에 의해 정의된 읽을 수 있는 속성 컬렉션을 반환합니다.

1
Value Digest.toJSON(String key = "");

호출 매개변수:

• key: 문자열, 사용되지 않음

결과 반환:

• Value, 직렬화 가능한 JSON을 포함하는 값을 반환합니다.