Import Certificate
Certificate cần có trước khi thêm Custom Domain, để API Gateway phục vụ domain đó qua HTTPS. Certificate được lưu cho cả tổ chức và dùng lại được cho Custom Domain trên mọi API Gateway.
Chuẩn bị Certificate và private key ở định dạng PEM trước khi import:
- Certificate bắt đầu bằng
-----BEGIN CERTIFICATE-----. Nếu có intermediate certificate, đưa cả chuỗi vào ô Certificate. - Private key bắt đầu bằng
-----BEGIN PRIVATE KEY-----hoặc-----BEGIN RSA PRIVATE KEY-----. - Domains (SAN) của Certificate phải bao gồm các Custom Domain bạn định thêm, ví dụ
*.yourcompany.com.
Nhấn vào ảnh để phóng to.
Import Certificate
Để import Certificate, bạn thực hiện các bước sau:
- Chọn API Gateway → Certificate ở menu bên trái, rồi nhấn Import.
Khi tổ chức chưa có Certificate nào, nhấn New certificate ở giữa màn hình.
- Nhập các thông tin sau tại form Import Certificate:
| Field | Bắt buộc | Mô tả |
|---|---|---|
| Name | Y | Tên Certificate. Tối đa 255 ký tự, bắt đầu bằng chữ cái, chỉ gồm chữ, số, _, - và dấu cách. Không trùng với Certificate khác trong tổ chức. |
| Certificate content | Y | Certificate ở định dạng PEM. Dán nội dung, hoặc nhấn Upload để tải file .pem / .crt (tối đa 1 MB). |
| Certificate private key | Y | Private key đi cùng Certificate, ở định dạng PEM. Dán nội dung, hoặc nhấn Upload để tải file .pem / .key (tối đa 1 MB). |
- Nhấn Import. Nút chỉ dùng được khi bạn đã nhập đủ 3 field và tên hợp lệ.
Thông báo Imported successfully. hiển thị và Certificate mới nằm ở đầu danh sách. Cột SNIs và Used by hiển thị - cho tới khi có Custom Domain dùng Certificate.
Sau khi import, private key không hiển thị lại trên bất kỳ màn hình nào.
Lỗi thường gặp
| Lỗi | Nguyên nhân | Cách xử lý |
|---|---|---|
| The certificate body provided is not in a valid PEM format. | Certificate content không phải Certificate ở định dạng PEM | Dán đủ cả khối, từ -----BEGIN CERTIFICATE----- đến -----END CERTIFICATE-----. |
| The certificate private key provided is not in a valid PEM format. | Certificate private key không phải private key ở định dạng PEM, ví dụ dán nhầm public key | Dán đúng khối private key. |
| Key provided does not match the certificate. | Private key thuộc Certificate khác | Dùng private key được tạo cùng Certificate này. |
| The certificate is expired. / The certificate has been revoked. | Certificate đã hết hạn hoặc bị thu hồi | Lấy Certificate mới từ tổ chức cấp Certificate. |
| Name already exists. | Tên trùng với Certificate khác trong tổ chức | Đặt tên khác. |
| This certificate is already imported as "<name>" (same issuer and serial number). | Certificate này đã được import vào tổ chức | Dùng Certificate đã có. |
| "<file>" is not a supported file. / is too large / does not contain PEM content. | File tải lên sai định dạng, lớn hơn 1 MB hoặc không chứa nội dung PEM | Tải file .pem, .crt hoặc .key ở định dạng PEM, tối đa 1 MB. |
Import Certificate từ form Custom Domain
Bạn cũng có thể import Certificate ngay khi thêm Custom Domain, chỉnh sửa Custom Domain hoặc thiết lập endpoint khi tạo API Gateway. Mở danh sách Certificate, nhấn + Import certificate ở cuối danh sách, rồi làm theo Bước 2 và Bước 3 ở trên. Sau khi import, hệ thống đưa bạn về form trước với Certificate mới đã được chọn sẵn.
