Language

SSLParameters.GetNamedGroups Method

Definition

Returns a prioritized array of key exchange named groups names that can be used over the SSL/TLS/DTLS protocols.

[Android.Runtime.Register("getNamedGroups", "()[Ljava/lang/String;", "GetGetNamedGroupsHandler", ApiSince=37)]
public virtual string[]? GetNamedGroups();
[<Android.Runtime.Register("getNamedGroups", "()[Ljava/lang/String;", "GetGetNamedGroupsHandler", ApiSince=37)>]
abstract member GetNamedGroups : unit -> string[]
override this.GetNamedGroups : unit -> string[]

Returns

String[]

an array of key exchange named group names Strings or null if none have been set. For non-null returns, this method will return a new array each time it is invoked. The array is ordered based on named group preference, with the first entry being the most preferred. Providers should ignore unknown named group names while establishing the SSL/TLS/DTLS connections.

Attributes

Remarks

Returns a prioritized array of key exchange named groups names that can be used over the SSL/TLS/DTLS protocols. Note that the standard list of key exchange named groups are defined in the Named Groups section of the Java Security Standard Algorithm Names Specification. Providers may support named groups not defined in this list or may not use the recommended name for a certain named group. The set of named groups that will be used over the SSL/TLS/DTLS connections is determined by the returned array of this method and the underlying provider-specific default named groups. If the returned array is null, then the underlying provider-specific default named groups will be used over the SSL/TLS/DTLS connections. If the returned array is empty (zero-length), then the named group negotiation mechanism is turned off for SSL/TLS/DTLS protocols, and the connections may not be able to be established if the negotiation mechanism is required by a certain SSL/TLS/DTLS protocol. This parameter will override the underlying provider-specific default name groups. If the returned array is not null or empty (zero-length), then the named groups in the returned array will be used over the SSL/TLS/DTLS connections. This parameter will override the underlying provider-specific default named groups. This method returns the most recent value passed to setNamedGroups(java.lang.String[]) if that method has been called and otherwise returns the default named groups for connection populated objects, or null for pre-populated objects.

Java reference for javax.net.ssl.SSLParameters.getNamedGroups.

Applies to