net.devh.boot.grpc.server.config

Class GrpcServerProperties.Security

java.lang.Object

net.devh.boot.grpc.server.config.GrpcServerProperties.Security

Enclosing class:

GrpcServerProperties

public static class GrpcServerProperties.Security
extends Object

The security configuration for the gRPC server.

Constructor Summary

Constructors

Constructor and Description
Security()

Method Summary

Modifier and Type	Method and Description
protected boolean	canEqual(Object other)
boolean	equals(Object o)
String	getCertificateChainPath() Path to SSL certificate chain.
List<String>	getCiphers() Specifies the cipher suite.
ClientAuth	getClientAuth() Whether the client has to authenticate himself via certificates.
String	getPrivateKeyPath() Path to private key.
String[]	getProtocols() Specifies the protocols accepted for secure connections.
String	getTrustCertCollectionPath() Path to the trusted certificate collection.
int	hashCode()
boolean	isEnabled() Flag that controls whether transport security is used.
void	setCertificateChainPath(String certificateChainPath) Path to SSL certificate chain.
void	setCiphers(String ciphers)
void	setClientAuth(ClientAuth clientAuth) Whether the client has to authenticate himself via certificates.
void	setEnabled(boolean enabled) Flag that controls whether transport security is used.
void	setPrivateKeyPath(String privateKeyPath) Path to private key.
void	setProtocols(String protocols)
void	setTrustCertCollectionPath(String trustCertCollectionPath) Path to the trusted certificate collection.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Security

public Security()

Method Detail

setCiphers

public void setCiphers(String ciphers)

setProtocols

public void setProtocols(String protocols)

isEnabled

public boolean isEnabled()

Flag that controls whether transport security is used. Defaults to false.

Returns:

True, if transport security should be enabled. False otherwise.

getCertificateChainPath

public String getCertificateChainPath()

Path to SSL certificate chain. Required if isEnabled() is true.

Returns:

The path to the certificate chain or null, if security is not enabled.

See Also:

GrpcSslContexts.forServer(File, File)

getPrivateKeyPath

public String getPrivateKeyPath()

Path to private key. Required if enabled is true.

Returns:

The path to the private key or null, if security is not enabled.

See Also:

GrpcSslContexts.forServer(File, File)

getClientAuth

public ClientAuth getClientAuth()

Whether the client has to authenticate himself via certificates. Can be either of NONE, OPTIONAL or REQUIRE. Defaults to ClientAuth.NONE.

Returns:

Whether the client has to authenticate himself via certificates.

See Also:

SslContextBuilder#clientAuth(ClientAuth)

getTrustCertCollectionPath

public String getTrustCertCollectionPath()

Path to the trusted certificate collection. If null or empty it will use the system's default collection (Default). This collection will be used to verify client certificates.

Returns:

The path to the trusted certificate collection or null.

See Also:

SslContextBuilder.trustManager(File)

getCiphers

public List<String> getCiphers()

Specifies the cipher suite. If null or empty it will use the system's default cipher suite.

Returns:

The cipher suite accepted for secure connections or null.

getProtocols

public String[] getProtocols()

Specifies the protocols accepted for secure connections. If null or empty it will use the system's default (all supported) protocols.

Returns:

The protocols accepted for secure connections or null.

setEnabled

public void setEnabled(boolean enabled)

Flag that controls whether transport security is used. Defaults to false.

Parameters:

enabled - Whether transport security should be enabled.

setCertificateChainPath

public void setCertificateChainPath(String certificateChainPath)

Path to SSL certificate chain. Required if isEnabled() is true.

Parameters:

certificateChainPath - The path to the certificate chain.

See Also:

GrpcSslContexts.forServer(File, File)

setPrivateKeyPath

public void setPrivateKeyPath(String privateKeyPath)

Path to private key. Required if enabled is true.

Parameters:

privateKeyPath - The path to the private key.

See Also:

GrpcSslContexts.forServer(File, File)

setClientAuth

public void setClientAuth(ClientAuth clientAuth)

Whether the client has to authenticate himself via certificates. Can be either of NONE, OPTIONAL or REQUIRE. Defaults to ClientAuth.NONE.

Parameters:

clientAuth - Whether the client has to authenticate himself via certificates.

See Also:

SslContextBuilder#clientAuth(ClientAuth)

setTrustCertCollectionPath

public void setTrustCertCollectionPath(String trustCertCollectionPath)

Path to the trusted certificate collection. If null or empty it will use the system's default collection (Default). This collection will be used to verify client certificates.

Parameters:

trustCertCollectionPath - The path to the trusted certificate collection.

See Also:

SslContextBuilder.trustManager(File)

equals

public boolean equals(Object o)

Overrides:

equals in class Object

canEqual

protected boolean canEqual(Object other)

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object