ObjectX509요구사항

X509Req 개체는 x509 인증서 요청을 생성하는 데 사용되는 개체이며 다음에 속합니다.crypto기준 치수

생성자를 통해 X509Req의 인스턴스를 생성할 수 있습니다. 생성자에서 매개변수를 전달하여 주체 고유 이름과 인증서의 공개 키를 지정할 수 있습니다. 예를 들면 다음과 같습니다.

1
2
3
4
var crypto = require('crypto');

let pky = crypto.PKey.from(private_pem);
let req = new crypto.X509Req("CN=localhost,O=fibjs", pky);

이 인스턴스를 사용하면 상위 클래스의 메서드와 속성을 호출하여 인증서 요청 개체에 대한 정보를 얻을 수 있습니다. 예를 들면 다음과 같습니다.

1
2
3
4
5
// return the DER format of the certificate request
let derReq = req.der();

// return the PEM format of the certificate request
let pemReq = req.pem();

X509Req 객체에 서명하여 공식 인증서 객체를 생성할 수도 있습니다. 예를 들면 다음과 같습니다.

1
2
3
4
5
6
7
let opt = {
    notBefore: new Date('2019-01-01') // valid from 2019-01-01
        ,
    notAfter: new Date('2029-12-31') // valid to 2029-12-31
};
let crt = req.sign("CN=myy.mkx", pky, opt);
// CN=myy.mkx is the issuer of the certificate

X509Req 개체는 인증서 자체가 아닌 x509 인증서 요청을 생성하는 데 사용되며, 유효한 인증서를 얻으려면 서명이 필요합니다. 동시에 인증서 서명에 사용된 공개 키는 인증서 요청에 사용된 공개 키와 일치해야 합니다.

상속관계

건설자

X509Req

X509Req 생성자

1
new X509Req();

---

X509Req 생성자는 주어진 정보를 기반으로 인증서 요청을 생성합니다.

1
2
3
new X509Req(String subject,
    PKey key,
    Integer hash = hash.SHA256);

호출 매개변수:

• subject: 문자열, 인증서의 주체 식별 이름
• key:PKey, 인증서의 공개 키
• hash: 정수, 인증서 다이제스트 알고리즘, 기본값은hash.SHA256

---

X509Req 생성자는 DER 형식으로 인증서 요청을 로드합니다.

1
new X509Req(Buffer derReq);

호출 매개변수:

• derReq:Buffer, DER 형식의 인증서 요청

---

X509Req 생성자는 PEM 형식으로 인증서 요청을 로드합니다.

1
new X509Req(String pemReq);

호출 매개변수:

• pemReq: 문자열, DER 형식의 인증서 요청

구성원 속성

subject

문자열, 인증서의 주체 고유 이름을 가져옵니다.

1
readonly String X509Req.subject;

---

publicKey

PKey, 인증서의 공개 키를 가져옵니다.

1
readonly PKey X509Req.publicKey;

---

sig_md

정수, 인증서를 얻기 위한 다이제스트 알고리즘

1
readonly Integer X509Req.sig_md;

---

sig_pk

정수, 인증서의 서명 알고리즘을 얻습니다.

1
readonly Integer X509Req.sig_pk;

멤버 함수

import

DER 형식으로 인증서 요청 로드

1
X509Req.import(Buffer derReq);

호출 매개변수:

• derReq:Buffer, DER 형식의 인증서 요청

---

PEM 형식으로 인증서 요청 로드

1
X509Req.import(String pemReq);

호출 매개변수:

• pemReq: 문자열, PEM 형식의 인증서 요청

---

pem

현재 인증서 요청의 PEM 형식 인코딩을 반환합니다.

1
String X509Req.pem();

결과 반환:

• String, 현재 인증서 요청의 PEM 형식 인코딩

---

der

현재 인증서 요청의 DER 형식 인코딩을 반환합니다.

1
Buffer X509Req.der();

결과 반환:

• Buffer, 현재 인증서 요청의 DER 형식 인코딩

---

sign

현재 인증서 요청을 공식 인증서로 서명합니다.

1
2
3
X509Cert X509Req.sign(String issuer,
    PKey key,
    Object opts = {}) async;

호출 매개변수:

• issuer: 문자열, 서명 기관의 고유 이름
• key:PKey, 서명 기관의 개인 키
• opts: 객체, 기타 선택적 매개변수

결과 반환:

• X509Cert, 서명된 공식 인증서를 반환합니다.

opts가 수신하는 필드는 다음과 같습니다.

1
2
3
4
5
6
7
8
{
    ca: false, // specify if the certificate is a CA certificate, default is false
    pathlen: -1, // specify the path length of the certificate, default is -1
    notBefore: "", // specify the certificate valid from date, default is current date
    notAfter: "", // specify the certificate valid to date, default is 365 days after current date
    usage: "", // specify the certificate usage, accept: digitalSignature, nonRepudiation, keyEncipherment, dataEncipherment, keyAgreement, keyCertSign, cRLSign
    type: "" // specify the certificate Netscape certificate type, accept: client, server, email, objsign, reserved, sslCA, emailCA, objCA
}

---

toString

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

1
String X509Req.toString();

결과 반환:

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

---

toJSON

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

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

호출 매개변수:

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

결과 반환:

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