SSLContext (Java Platform SE 8)

java.lang.Object
- javax.net.ssl.SSLContext

```
public class SSLContext
extends Object
```
このクラスのインスタンスは、セキュア・ソケット・ファクトリまたはSSLEngineのファクトリとして機能する、セキュア・ソケット・プロトコルの実装を表します。このクラスは、キー・マネージャと信頼マネージャの任意の組み合わせ、および安全な乱数バイトのソースを使用して初期化されます。
Javaプラットフォームの実装は、すべて次の標準のSSLContextプロトコルをサポートする必要があります。
- TLSv1
このプロトコルについては、Java暗号化アーキテクチャ標準アルゴリズム名のドキュメントのSSLContextのセクションで説明されています。サポートされているその他のアルゴリズムについては、実装のリリース・ドキュメントを参照してください。
導入されたバージョン:

1.4

コンストラクタのサマリー

コンストラクタ
修飾子	コンストラクタ	説明
`protected`	`SSLContext(SSLContextSpi contextSpi, Provider provider, String protocol)`	SSLContextオブジェクトを生成します。

メソッドのサマリー

すべてのメソッド staticメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッド	説明
`SSLEngine`	`createSSLEngine()`	このコンテキストを使用して、新しい`SSLEngine`を作成します。
`SSLEngine`	`createSSLEngine(String peerHost, int peerPort)`	補足的なピア情報を使用して、このコンテキストを使用する新しい`SSLEngine`を作成します。
`SSLSessionContext`	`getClientSessionContext()`	クライアント・セッション・コンテキストを返します。このコンテキストには、クライアント側SSLソケットのハンドシェーク中に使用できるSSLセッションが指定されています。
`static SSLContext`	`getDefault()`	デフォルトのSSLコンテキストを返します。
`SSLParameters`	`getDefaultSSLParameters()`	このSSLコンテキストのデフォルト設定を示すSSLParametersのコピーを返します。
`static SSLContext`	`getInstance(String protocol)`	指定されたセキュア・ソケット・プロトコルを実装する`SSLContext`オブジェクトを返します。
`static SSLContext`	`getInstance(String protocol, Provider provider)`	指定されたセキュア・ソケット・プロトコルを実装する`SSLContext`オブジェクトを返します。
`static SSLContext`	`getInstance(String protocol, String provider)`	指定されたセキュア・ソケット・プロトコルを実装する`SSLContext`オブジェクトを返します。
`String`	`getProtocol()`	この`SSLContext`オブジェクトのプロトコル名を返します。
`Provider`	`getProvider()`	この`SSLContext`オブジェクトのプロバイダを返します。
`SSLSessionContext`	`getServerSessionContext()`	サーバー・セッション・コンテキストを返します。このコンテキストには、サーバー側SSLソケットのハンドシェーク中に使用できるSSLセッションが指定されています。
`SSLServerSocketFactory`	`getServerSocketFactory()`	このコンテキストの`ServerSocketFactory`オブジェクトを返します。
`SSLSocketFactory`	`getSocketFactory()`	このコンテキストの`SocketFactory`オブジェクトを返します。
`SSLParameters`	`getSupportedSSLParameters()`	このSSLコンテキストでサポートされる設定を示すSSLParametersのコピーを返します。
`void`	`init(KeyManager[] km, TrustManager[] tm, SecureRandom random)`	このコンテキストを初期化します。
`static void`	`setDefault(SSLContext context)`	デフォルトのSSLコンテキストを設定します。

クラス java.lang.Objectから継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- コンストラクタの詳細
  - SSLContext
```
protected SSLContext(SSLContextSpi contextSpi,
                     Provider provider,
                     String protocol)
```
    SSLContextオブジェクトを生成します。
    
    パラメータ:
    
    contextSpi - 委譲先
    
    provider - プロバイダ
    
    protocol - プロトコル
- メソッドの詳細
  - getDefault
```
public static SSLContext getDefault()
                             throws NoSuchAlgorithmException
```
    デフォルトのSSLコンテキストを返します。
    SSLContext.setDefault()メソッドを使用してデフォルト・コンテキストが設定されていた場合は、そのデフォルト・コンテキストが返されます。そうでない場合は、このメソッドを最初に呼び出したときにSSLContext.getInstance("Default")の呼出しがトリガーされます。成功すると、そのオブジェクトがデフォルトのSSLコンテキストになり、返されます。
    デフォルト・コンテキストはすぐに使用可能となり、初期化する必要はありません。
    
    戻り値:
    
    デフォルトのSSLコンテキスト
    
    例外:
    
    NoSuchAlgorithmException - SSLContext.getInstance()の呼出しが失敗した場合
    
    導入されたバージョン:
    
    1.6
  - setDefault
```
public static void setDefault(SSLContext context)
```
    デフォルトのSSLコンテキストを設定します。これは、後続のgetDefault()の呼出しで返されます。デフォルト・コンテキストはすぐに使用可能となり、初期化する必要はありません。
    
    パラメータ:
    
    context - SSLContext
    
    例外:
    
    NullPointerException - コンテキストがnullである場合
    
    SecurityException - セキュリティ・マネージャが存在し、そのcheckPermissionメソッドがSSLPermission("setDefaultSSLContext")が許可しない場合
    
    導入されたバージョン:
    
    1.6
  - getInstance
```
public static SSLContext getInstance(String protocol)
                              throws NoSuchAlgorithmException
```
    指定されたセキュア・ソケット・プロトコルを実装するSSLContextオブジェクトを返します。
    このメソッドは、最優先のProviderから順に、登録済みのセキュリティProviderのリストをトラバースします。指定されたアルゴリズムをサポートする最初のプロバイダのSSLContextSpi実装をカプセル化する新しいSSLContextオブジェクトが返されます。
    登録済みプロバイダのリストは、Security.getProviders()メソッド経由で取得できます。
    
    パラメータ:
    
    protocol - 要求されたプロトコルの標準名。標準のプロトコル名については、Java暗号化アーキテクチャ標準アルゴリズム名のドキュメントのSSLContextのセクションを参照。
    
    戻り値:
    
    新しいSSLContextオブジェクト。
    
    例外:
    
    NoSuchAlgorithmException - 指定されたプロトコルのSSLContextSpi実装をサポートするプロバイダが存在しない場合。
    
    NullPointerException - プロトコルがnullである場合。
    
    関連項目:
    
    Provider
  - getInstance
```
public static SSLContext getInstance(String protocol,
                                     String provider)
                              throws NoSuchAlgorithmException,
                                     NoSuchProviderException
```
    指定されたセキュア・ソケット・プロトコルを実装するSSLContextオブジェクトを返します。
    指定されたプロバイダのSSLContextSpi実装をカプセル化する新しいSSLContextオブジェクトが返されます。指定したプロバイダは、セキュリティ・プロバイダ・リストに登録する必要があります。
    登録済みプロバイダのリストは、Security.getProviders()メソッド経由で取得できます。
    
    パラメータ:
    
    protocol - 要求されたプロトコルの標準名。標準のプロトコル名については、Java暗号化アーキテクチャ標準アルゴリズム名のドキュメントのSSLContextのセクションを参照。
    
    provider - プロバイダ名。
    
    戻り値:
    
    新しいSSLContextオブジェクト。
    
    例外:
    
    NoSuchAlgorithmException - 指定されたプロバイダに、指定されたプロトコルのSSLContextSpiの実装がない場合。
    
    NoSuchProviderException - 指定されたプロバイダがセキュリティ・プロバイダ・リストに登録されていない場合。
    
    IllegalArgumentException - プロバイダ名がnullまたは空の場合。
    
    NullPointerException - プロトコルがnullである場合。
    
    関連項目:
    
    Provider
  - getInstance
```
public static SSLContext getInstance(String protocol,
                                     Provider provider)
                              throws NoSuchAlgorithmException
```
    指定されたセキュア・ソケット・プロトコルを実装するSSLContextオブジェクトを返します。
    指定されたProviderオブジェクトのSSLContextSpi実装をカプセル化する新しいSSLContextオブジェクトが返されます。指定されたProviderオブジェクトは、プロバイダ・リストに登録する必要はありません。
    
    パラメータ:
    
    protocol - 要求されたプロトコルの標準名。標準のプロトコル名については、Java暗号化アーキテクチャ標準アルゴリズム名のドキュメントのSSLContextのセクションを参照。
    
    provider - プロバイダのインスタンス。
    
    戻り値:
    
    新しいSSLContextオブジェクト。
    
    例外:
    
    NoSuchAlgorithmException - 指定されたProviderオブジェクトに、指定されたプロトコルのSSLContextSpi実装がない場合。
    
    IllegalArgumentException - プロバイダがnullの場合。
    
    NullPointerException - プロトコルがnullである場合。
    
    関連項目:
    
    Provider
  - getProtocol
```
public final String getProtocol()
```
    このSSLContextオブジェクトのプロトコル名を返します。
    これは、このSSLContextオブジェクトを作成したgetInstance呼出しのいずれかに指定された名前と同じです。
    
    戻り値:
    
    このSSLContextオブジェクトのプロトコル名。
  - getProvider
```
public final Provider getProvider()
```
    このSSLContextオブジェクトのプロバイダを返します。
    
    戻り値:
    
    このSSLContextオブジェクトのプロバイダ
  - init
```
public final void init(KeyManager[] km,
                       TrustManager[] tm,
                       SecureRandom random)
                throws KeyManagementException
```
    このコンテキストを初期化します。最初の2つのパラメータのどちらかをnullにした場合は、インストールされているセキュリティ・プロバイダから、該当するファクトリのもっとも優先順位の高い実装が検索されます。同様に、SecureRandomパラメータをnullにした場合は、デフォルトの実装が使用されます。
    キー・マネージャや信頼マネージャは、配列内に最初に配置されている実装型のインスタンスだけが使用されます。 (たとえば、配列内の最初のjavax.net.ssl.X509KeyManagerだけが使用される)。
    
    パラメータ:
    
    km - 認証キーのソース、またはnull
    
    tm - ピア認証の信頼を判断するソース、またはnull
    
    random - このジェネレータの乱数発生の元、またはnull
    
    例外:
    
    KeyManagementException - この操作が失敗した場合
  - getSocketFactory
```
public final SSLSocketFactory getSocketFactory()
```
    このコンテキストのSocketFactoryオブジェクトを返します。
    
    戻り値:
    
    SocketFactoryオブジェクト
    
    例外:
    
    IllegalStateException - SSLContextImplに初期化が必要であり、init()が呼び出されていない場合
  - getServerSocketFactory
```
public final SSLServerSocketFactory getServerSocketFactory()
```
    このコンテキストのServerSocketFactoryオブジェクトを返します。
    
    戻り値:
    
    ServerSocketFactoryオブジェクト
    
    例外:
    
    IllegalStateException - SSLContextImplに初期化が必要であり、init()が呼び出されていない場合
  - createSSLEngine
```
public final SSLEngine createSSLEngine()
```
    このコンテキストを使用して、新しいSSLEngineを作成します。
    このファクトリ・メソッドを使用しているアプリケーションは、内部セッションの再利用に関するヒントを提供しません。ヒントが必要な場合は、代わりにcreateSSLEngine(String, int)を使用するようにしてください。
    Kerberosなど、リモート・ホスト名の情報を必要とする暗号化方式群もあります。この場合は、このファクトリ・メソッドを使用しないでください。
    
    戻り値:
    
    SSLEngineオブジェクト
    
    例外:
    
    UnsupportedOperationException - ベースとなるプロバイダがこの操作を実装していない場合。
    
    IllegalStateException - SSLContextImplに初期化が必要であり、init()が呼び出されていない場合
    
    導入されたバージョン:
    
    1.5
  - createSSLEngine
```
public final SSLEngine createSSLEngine(String peerHost,
                                       int peerPort)
```
    補足的なピア情報を使用して、このコンテキストを使用する新しいSSLEngineを作成します。
    このファクトリ・メソッドを使用しているアプリケーションは、内部セッションの再利用に関するヒントを提供します。
    Kerberosなど、リモート・ホスト名の情報を必要とする暗号化方式群もあります。この場合は、peerHostを指定する必要があります。
    
    パラメータ:
    
    peerHost - ホストの権限のない名前
    
    peerPort - 権限のないポート
    
    戻り値:
    
    新しいSSLEngineオブジェクト
    
    例外:
    
    UnsupportedOperationException - ベースとなるプロバイダがこの操作を実装していない場合。
    
    IllegalStateException - SSLContextImplに初期化が必要であり、init()が呼び出されていない場合
    
    導入されたバージョン:
    
    1.5
  - getServerSessionContext
```
public final SSLSessionContext getServerSessionContext()
```
    サーバー・セッション・コンテキストを返します。このコンテキストには、サーバー側SSLソケットのハンドシェーク中に使用できるSSLセッションが指定されています。
    コンテキストは、一部の環境では取得できません。その場合はnullを返します。たとえば、ベースとなるSSLプロバイダがSSLSessionContextインタフェースの実装を提供していない場合は、このメソッドはnullを返します。それ以外の場合は、null以外のセッション・コンテキストが返されます。
    
    戻り値:
    
    このSSLコンテキストにバインドされているサーバー・セッション・コンテキスト
  - getClientSessionContext
```
public final SSLSessionContext getClientSessionContext()
```
    クライアント・セッション・コンテキストを返します。このコンテキストには、クライアント側SSLソケットのハンドシェーク中に使用できるSSLセッションが指定されています。
    コンテキストは、一部の環境では取得できません。その場合はnullを返します。たとえば、ベースとなるSSLプロバイダがSSLSessionContextインタフェースの実装を提供していない場合は、このメソッドはnullを返します。それ以外の場合は、null以外のセッション・コンテキストが返されます。
    
    戻り値:
    
    このSSLコンテキストにバインドされているクライアント・セッション・コンテキスト
  - getDefaultSSLParameters
```
public final SSLParameters getDefaultSSLParameters()
```
    このSSLコンテキストのデフォルト設定を示すSSLParametersのコピーを返します。
    パラメータは、null値以外に設定された暗号化方式群とプロトコル配列を常に持ちます。
    
    戻り値:
    
    デフォルト設定を持つSSLParametersオブジェクトのコピー
    
    例外:
    
    UnsupportedOperationException - デフォルトのSSLパラメータを取得できなかった場合。
    
    導入されたバージョン:
    
    1.6
  - getSupportedSSLParameters
```
public final SSLParameters getSupportedSSLParameters()
```
    このSSLコンテキストでサポートされる設定を示すSSLParametersのコピーを返します。
    パラメータは、null値以外に設定された暗号化方式群とプロトコル配列を常に持ちます。
    
    戻り値:
    
    サポートされる設定を持つSSLParametersオブジェクトのコピー
    
    例外:
    
    UnsupportedOperationException - サポートされるSSLパラメータを取得できなかった場合。
    
    導入されたバージョン:
    
    1.6

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラスSSLContext

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Objectから継承されたメソッド

コンストラクタの詳細

SSLContext

メソッドの詳細

getDefault

setDefault

getInstance

getInstance

getInstance

getProtocol

getProvider

init

getSocketFactory

getServerSocketFactory

createSSLEngine

createSSLEngine

getServerSessionContext

getClientSessionContext

getDefaultSSLParameters

getSupportedSSLParameters