---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# CertificateEncryption - スコープ指定

# CertificateEncryption - スコープ指定 {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：4分

CertificateEncryption API は、スコープ対象のアプリケーションで証明書を暗号化するためのメソッドを提供します。

これらのメソッドを使用して、証明書のハッシュを生成し、秘密鍵を使用してデータに署名し、メッセージ認証コードを生成します。

## CertificateEncryption - CertificateEncryption() {#ariaid-title2}

スコープ対象のアプリケーションで CertificateEncryption オブジェクトをインスタンス化します。
{#r-SCE-CE__table_e1m_npx_vz__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 1. パラメーター]

{#r-SCE-CE__table_e1m_npx_vz}

## CertificateEncryption - generateMac(文字列 key, 文字列 algorithm, 文字列 data) {#ariaid-title3}

メッセージの認証に使用されるメッセージ認証コード (MAC) を生成します。
{#r_SCE-generateMac_S_S_S__table_nm3_gcc_ks__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| key | 文字列 | メッセージへの署名に使用するキーです。Base64 でエンコードする必要があります。 |
| アルゴリズム | 文字列 | MAC の生成に使用するアルゴリズムです (HmacSHA256、HmacSHA1、HmacMD5)。 |
| データ | 文字列 | 処理するデータです。 |
[表 : 2. パラメーター]

{#r_SCE-generateMac_S_S_S__table_nm3_gcc_ks} {#r_SCE-generateMac_S_S_S__table_om3_gcc_ks__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | base64 形式の MAC |
[表 : 3. 返される内容]

{#r_SCE-generateMac_S_S_S__table_om3_gcc_ks}  
この例は、data として sample_key を使用し、algorithm として HmacSHA256 を使用する方法を示しています。

    var mac = new CertificateEncryption;
    var key = "sample_key"; 
    key = gs.base64Encode(key);
    mac.generateMac(key, "HmacSHA256", "sample_data");

## CertificateEncryption - getThumbPrint(文字列 certificateID, 文字列 algorithm) {#ariaid-title4}

信頼できるストア証明書からの証明書のハッシュ (SHA-1、SHA-256 など) を生成します。
{#r_SCE-getThumbPrint_S_S__table_edb_rmv_js__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| certificateID | 文字列 | X.509 証明書 \[sys_certificate\] テーブルの証明書レコードの sys_id です。 |
| アルゴリズム | 文字列 | ハッシュの作成に使用するアルゴリズムです (SHA-1、SHA-256 など)。 |
[表 : 4. パラメーター]

{#r_SCE-getThumbPrint_S_S__table_edb_rmv_js} {#r_SCE-getThumbPrint_S_S__table_fdb_rmv_js__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | base64 形式のサムプリント |
[表 : 5. 返される内容]

{#r_SCE-getThumbPrint_S_S__table_fdb_rmv_js}  
この例は、AzureAAD 証明書のサムプリント (ハッシュ) を生成する方法を示しています。

    //Create a GlideRecord to the certificate table
    var x509GR = new GlideRecord('sys_certificate');

    //If there is a certificate of a name of AzureAAD, get the certificate thumbprint
    if(x509GR.get('name', 'AzureAAD')){

    //Use the sys_id and algorithm we want to create a thumbprint
    var thumbPrint = CertificateEncryption.getThumbPrint(x509GR.getUniqueValue(), "SHA-1");

    //Print the created thumbprint
    gs.print("Thumbprint for " + x509GR.getDisplayValue() + " is " + thumbPrint);
    }

出力:

    V1X+aguDBTZVVbWMGTXxdzJLmaY=

## CertificateEncryption - getThumbPrintFromKeyStore(文字列 certificateID, 文字列 alias, 文字列 algorithm) {#ariaid-title5}

キーストア エントリから証明書のハッシュ (SHA-1、SHA-256など) を生成します。
{#r_SCE-getThumbPrintFromKeyStore_S_S_S__table_edb_rmv_js__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| certificateID | 文字列 | X.509 証明書 \[sys_certificate\] テーブルの証明書レコードの sys_id です。 |
| エイリアス | 文字列 | 証明書のエイリアス名 |
| アルゴリズム | 文字列 | ハッシュの作成に使用するアルゴリズムです (SHA-1、SHA-256 など)。 |
[表 : 6. パラメーター]

{#r_SCE-getThumbPrintFromKeyStore_S_S_S__table_edb_rmv_js} {#r_SCE-getThumbPrintFromKeyStore_S_S_S__table_fdb_rmv_js__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | base64 形式のサムプリント |
[表 : 7. 返される内容]

{#r_SCE-getThumbPrintFromKeyStore_S_S_S__table_fdb_rmv_js}

## CertificateEncryption - sign(文字列 certificateID, 文字列 alias, 文字列 aliaspassword, 文字列 algorithm, 文字列 datatosign) {#ariaid-title6}

秘密鍵と指定されたアルゴリズムを使用してデータに署名します。
{#r_SCE-sign_certificateID_S_S_S_S__table_edb_rmv_js__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| certificateID | 文字列 | X.509 証明書 \[sys_certificate\] テーブルの証明書レコードの sys_id |
| エイリアス | 文字列 | 秘密キー名 |
| aliaspassword | 文字列 | 秘密キーのパスワード |
| アルゴリズム | 文字列 | 使用するアルゴリズムです。次のいずれかの値を使用する必要があります。 * NONEwithRSA * MD2withRSA * MD5withRSA * SHA1withRSA * SHA224withRSA * SHA256withRSA * SHA384withRSA * SHA512withRSA * NONEwithDSA * SHA1withDSA * SHA224withDSA * SHA256withDSA * NONEwithECDSA * SHA1withECDSA * SHA224withECDSA * SHA256withECDSA * SHA384withECDSA * SHA512withECDSA {#r_SCE-sign_certificateID_S_S_S_S__ul_pr3_nvv_pkb} |
| datatosign | 文字列 | 署名するデータ |
[表 : 8. パラメーター]

{#r_SCE-sign_certificateID_S_S_S_S__table_edb_rmv_js} {#r_SCE-sign_certificateID_S_S_S_S__table_r3m_jcb_ks__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | base64 形式で署名されたデータ |
[表 : 9. 返される内容]

{#r_SCE-sign_certificateID_S_S_S_S__table_r3m_jcb_ks}  

    var ce = new CertificateEncryption;
    ce.sign("recordID", "alias", "password", "SHA1withRSA", "sign this data");