Ruby 1.9.3 リファレンスマニュアル > ライブラリ一覧 > opensslライブラリ > OpenSSL::X509::CRLクラス

class OpenSSL::X509::CRL

クラスの継承リスト: OpenSSL::X509::CRL < Object < Kernel < BasicObject

要約

CRL(証明書失効リスト) クラス。

CRL とは、危殆化した等なんらかの理由で失効した証明書のリストです。 通常 CA によって発行されるものです。 OpenSSL::X509::Store に組込むことで失効した証明書の検証を 失敗させることができます。

通常 CRL の信頼性を確認するためには CRL になされた 署名を検証する必要があります。

• [RFC5280]

new -> OpenSSL::X509::CRL

new(obj) -> OpenSSL::X509::CRL

CRL(証明書失効リスト)オブジェクトを生成します。

新しい OpenSSL::X509::Request オブジェクトを生成します。

引数なしの場合は空の OpenSSL::X509::Request オブジェクトを生成します。

引数が文字列の場合は、PEM 形式もしくは DER 形式であると みなしてオブジェクトを生成します。

引数が IO オブジェクトである場合は、そのファイルの中身から オブジェクトを生成します。

引数が OpenSSL::X509::CRL である場合には、その内容を コピーしたオブジェクトを生成します。

引数が to_der メソッドを持つ場合は、そのメソッドによって DER 形式の文字列に変換してからオブジェクトを生成します。

[PARAM] obj:

CRL のデータ

[EXCEPTION] OpenSSL::X509::CRLError:

オブジェクトの生成に失敗した場合に発生します

add_extension(ex) -> OpenSSL::X509::Extension

拡張領域に ex を追加します。

追加するデータは OpenSSL::X509::Extension のオブジェクトを渡します。

ex を返します。

[PARAM] ex:

追加するデータ

[EXCEPTION] OpenSSL::X509::CRLError:

追加に失敗した場合に発生します

add_revoked(rev) -> OpenSSL::X509::Revoked

失効証明書リストに新たな要素を加えます。

rev は失効した証明書を表す OpenSSL::X509::Revoked オブジェクトです。

帰り値は rev です。

[PARAM] rev:

追加する失効した証明書を表すオブジェクト

[EXCEPTION] OpenSSL::X509::CRLError:

追加に失敗した場合に発生します

extensions -> [OpenSSL::X509::Extension]

CRL が持っている拡張領域のデータを配列で返します。

extensions=(extensions)

CRL の拡張領域を extensions で更新します。

extensions には OpenSSL::X509::Extension の配列を渡します。

更新前の拡張領域のデータは破棄されます。

[PARAM] extensions:

拡張領域のデータ

[EXCEPTION] OpenSSL::X509::CRLError:

更新に失敗した場合に発生します

issuer -> OpenSSL::X509::Name

CRL の発行者を返します。

issuer=(issuer)

CRL の発行者を設定します。

[PARAM] issuer:

発行者の OpenSSL::X509::Name オブジェクト

[EXCEPTION] OpenSSL::X509::CRLError:

設定に失敗した場合に発生します

[SEE_ALSO] OpenSSL::X509::CRL#issuer

last_update -> Time

CRL が最後に更新された日時を Time オブジェクトで返します。

last_update=(time)

CRL が最後に更新された日時を Time オブジェクトで設定します。

[PARAM] time:

最終更新日時

[EXCEPTION] OpenSSL::X509::CRLError:

設定に失敗した場合に発生します

[SEE_ALSO] OpenSSL::X509::CRL#last_update

next_update -> Time

CRL の次回更新日時を Time オブジェクトで返します。

next_update=(time)

CRL の次回更新日時を Time オブジェクトで設定します。

[PARAM] time:

最終更新日時

[EXCEPTION] OpenSSL::X509::CRLError:

設定に失敗した場合に発生します

[SEE_ALSO] OpenSSL::X509::CRL#next_update

revoked -> [OpenSSL::X509::Revoked]

自身が持っている失効した証明書の配列を返します。

revoked=(revs)

失効証明書リストを更新します。

このメソッドを呼びだす前のリストは破棄されます。 revs には失効した証明書を OpenSSL::X509::Revoked の配列で渡します。

[PARAM] revs:

設定する失効した証明書の配列

[EXCEPTION] OpenSSL::X509::CRLError:

設定に失敗した場合に発生します

sign(pkey, digest) -> self

CRL に秘密鍵で署名します。

[PARAM] pkey:

秘密鍵(OpenSSL::PKey::PKey オブジェクト)

[PARAM] digest:

ハッシュアルゴリズム

[EXCEPTION] OpenSSL::X509::CRLError:

署名に失敗した場合に発生します

signature_algorithm -> String

署名に使ったアルゴリズム名を文字列で返します。

[EXCEPTION] OpenSSL::X509::CRLError:

名前の取得に失敗した場合に発生します

to_der -> String

DER 形式に変換します。

[EXCEPTION] OpenSSL::X509::CRLError:

変換に失敗した場合に発生します

to_pem -> String

to_s -> String

PEM 形式に変換します。

[EXCEPTION] OpenSSL::X509::CRLError:

変換に失敗した場合に発生します

to_text -> String

人間が読める形式に変換します。

[EXCEPTION] OpenSSL::X509::CRLError:

変換に失敗した場合に発生します

verify(key) -> bool

発行者の公開鍵で CRL に記載されている署名を検証します。

検証に成功した場合は true を返します。

[PARAM] key:

公開鍵(OpenSSL::PKey::PKey オブジェクト)

[EXCEPTION] OpenSSL::X509::CRLError:

検証時にエラーが生じた場合に発生します

version -> Integer

その CRL が準拠している規格のバージョンを返します。

X.509 v2 CRL であれば 1 を返します。

[SEE_ALSO] OpenSSL::X509::CRL#version=

version=(version)

その CRL が準拠している規格のバージョンを設定します。

X.509 v2 CRL であれば 1 を渡します。

[PARAM] version:

設定するバージョンの整数

[EXCEPTION] OpenSSL::X509::CRLError:

設定に失敗した場合に発生します

[SEE_ALSO] OpenSSL::X509::CRL#version