SSLParameters (Java Platform SE 7)

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

```
public class SSLParameters
extends Object
```
SSL/TLS 接続のパラメータをカプセル化します。パラメータは、SSL/TLS ハンドシェークで受け入れられる暗号化方式群のリスト、許可されるプロトコルのリスト、SSL/TLS ハンドシェークでのエンドポイント識別アルゴリズム、アルゴリズムの制約、および SSL/TLS サーバーがクライアント認証を要求または必要とするかどうかです。
SSLParameters は、このクラスのコンストラクタを使用して作成することができます。オブジェクトは、SSLSocket、SSLServerSocket、および SSLEngine のgetSSLParameters() メソッド、または SSLContext の getDefaultSSLParameters() メソッドと getSupportedSSLParameters() メソッドを使用して取得することもできます。
SSLParameters は、SSLSocket.setSSLParameters()、SSLServerSocket.setSSLParameters()、および SSLEngine.getSSLParameters() メソッドを使用して、接続に適用することができます。

導入されたバージョン:

1.6

関連項目:
SSLSocket, SSLEngine, SSLContext

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

コンストラクタ
コンストラクタと説明
`SSLParameters()` SSLParameters を構築します。
`SSLParameters(String[] cipherSuites)` 指定された暗号化方式群の配列から SSLParameters を構築します。
`SSLParameters(String[] cipherSuites, String[] protocols)` 指定された暗号化方式群とプロトコルの配列から SSLParameters を構築します。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`AlgorithmConstraints`	`getAlgorithmConstraints()` 暗号化アルゴリズムの制約を返します。
`String[]`	`getCipherSuites()` 暗号化方式群の配列のコピーを返します。設定されていない場合は null を返します。
`String`	`getEndpointIdentificationAlgorithm()` エンドポイント識別アルゴリズムを取得します。
`boolean`	`getNeedClientAuth()` クライアント認証を必須とするかどうかを返します。
`String[]`	`getProtocols()` プロトコルの配列のコピーを返します。設定されていない場合は null を返します。
`boolean`	`getWantClientAuth()` クライアント認証を要求するかどうかを返します。
`void`	`setAlgorithmConstraints(AlgorithmConstraints constraints)` 実行環境によって構成された任意の制約に加えて使用される、暗号化アルゴリズムの制約を設定します。
`void`	`setCipherSuites(String[] cipherSuites)` 暗号化方式群の配列を設定します。
`void`	`setEndpointIdentificationAlgorithm(String algorithm)` エンドポイント識別アルゴリズムを設定します。
`void`	`setNeedClientAuth(boolean needClientAuth)` クライアント認証を必須とするかどうかを設定します。
`void`	`setProtocols(String[] protocols)` プロトコルの配列を設定します。
`void`	`setWantClientAuth(boolean wantClientAuth)` クライアント認証を要求するかどうかを設定します。

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

- コンストラクタの詳細
  - SSLParameters
```
public SSLParameters()
```
    SSLParameters を構築します。
    cipherSuites および protocols の値は null に設定され、wantClientAuth および needClientAuth は false に設定されます。
  - SSLParameters
```
public SSLParameters(String[] cipherSuites)
```
    指定された暗号化方式群の配列から SSLParameters を構築します。
    このコンストラクタの呼び出しは、引数なしのコンストラクタに続いて setCipherSuites(cipherSuites); を呼び出すことと同じです。
    
    パラメータ:
    cipherSuites - 暗号化方式群の配列 (null も可)
  - SSLParameters
```
public SSLParameters(String[] cipherSuites,
             String[] protocols)
```
    指定された暗号化方式群とプロトコルの配列から SSLParameters を構築します。
    このコンストラクタの呼び出しは、引数なしのコンストラクタに続いて setCipherSuites(cipherSuites); setProtocols(protocols); を呼び出すことと同じです。
    
    パラメータ:
    cipherSuites - 暗号化方式群の配列 (null も可)
    protocols - プロトコルの配列 (null も可)
- メソッドの詳細
  - getCipherSuites
```
public String[] getCipherSuites()
```
    暗号化方式群の配列のコピーを返します。設定されていない場合は null を返します。
    
    戻り値:
    暗号化方式群の配列のコピー。設定されていない場合は null。
  - setCipherSuites
```
public void setCipherSuites(String[] cipherSuites)
```
    暗号化方式群の配列を設定します。
    
    パラメータ:
    cipherSuites - 暗号化方式群の配列 (null も可)
  - getProtocols
```
public String[] getProtocols()
```
    プロトコルの配列のコピーを返します。設定されていない場合は null を返します。
    
    戻り値:
    プロトコルの配列のコピー。設定されていない場合は null。
  - setProtocols
```
public void setProtocols(String[] protocols)
```
    プロトコルの配列を設定します。
    
    パラメータ:
    protocols - プロトコルの配列 (null も可)
  - getWantClientAuth
```
public boolean getWantClientAuth()
```
    クライアント認証を要求するかどうかを返します。
    
    戻り値:
    クライアント認証を要求するかどうか。
  - setWantClientAuth
```
public void setWantClientAuth(boolean wantClientAuth)
```
    クライアント認証を要求するかどうかを設定します。このメソッドを呼び出すと、needClientAuth フラグがクリアーされます。
    
    パラメータ:
    wantClientAuth - クライアント認証が要求されるかどうか
  - getNeedClientAuth
```
public boolean getNeedClientAuth()
```
    クライアント認証を必須とするかどうかを返します。
    
    戻り値:
    クライアント認証を必須とするかどうか。
  - setNeedClientAuth
```
public void setNeedClientAuth(boolean needClientAuth)
```
    クライアント認証を必須とするかどうかを設定します。このメソッドを呼び出すと、wantClientAuth フラグがクリアーされます。
    
    パラメータ:
    needClientAuth - クライアント認証が必要かどうか
  - getAlgorithmConstraints
```
public AlgorithmConstraints getAlgorithmConstraints()
```
    暗号化アルゴリズムの制約を返します。
    
    戻り値:
    暗号化アルゴリズムの制約。制約が設定されていない場合は null
    導入されたバージョン:
    
    1.7
    
    関連項目:
    setAlgorithmConstraints(AlgorithmConstraints)
  - setAlgorithmConstraints
```
public void setAlgorithmConstraints(AlgorithmConstraints constraints)
```
    実行環境によって構成された任意の制約に加えて使用される、暗号化アルゴリズムの制約を設定します。
    constraints パラメータが null ではない場合は、SSL/TLS ハンドシェークで使用されるすべての暗号化アルゴリズム、鍵およびアルゴリズムパラメータが制約によって許容される必要があります。
    
    パラメータ:
    constraints - アルゴリズムの制約 (または null)
    導入されたバージョン:
    
    1.7
  - getEndpointIdentificationAlgorithm
```
public String getEndpointIdentificationAlgorithm()
```
    エンドポイント識別アルゴリズムを取得します。
    
    戻り値:
    エンドポイント識別アルゴリズム。設定されていない場合は null。
    導入されたバージョン:
    
    1.7
    
    関連項目:
    X509ExtendedTrustManager, setEndpointIdentificationAlgorithm(String)
  - setEndpointIdentificationAlgorithm
```
public void setEndpointIdentificationAlgorithm(String algorithm)
```
    エンドポイント識別アルゴリズムを設定します。
    algorithm パラメータが null または空ではない場合は、SSL/TLS ハンドシェークの際に、エンドポイント識別/検証プロシージャーを実行する必要があります。これを行うのは、man-in-the-middle 攻撃を回避するためです。
    
    パラメータ:
    algorithm - エンドポイント識別アルゴリズムの標準名を表す文字列 (または null)。標準のアルゴリズム名については、「Java 暗号化アーキテクチャー API の仕様およびリファレンス」の「付録 A」を参照してください。
    導入されたバージョン:
    
    1.7
    
    関連項目:
    X509ExtendedTrustManager

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

クラス SSLParameters

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

メソッドのサマリー

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

コンストラクタの詳細

SSLParameters

SSLParameters

SSLParameters

メソッドの詳細

getCipherSuites

setCipherSuites

getProtocols

setProtocols

getWantClientAuth

setWantClientAuth

getNeedClientAuth

setNeedClientAuth

getAlgorithmConstraints

setAlgorithmConstraints

getEndpointIdentificationAlgorithm

setEndpointIdentificationAlgorithm