1. Home
2. Working with Play
3. Common topics
4. Configuration

§Configuring WS SSL

Play WS allows you to set up HTTPS completely from a configuration file, without the need to write code. It does this by layering the Java Secure Socket Extension (JSSE) with a configuration layer and with reasonable defaults.

§Table of Contents

The Play WS configuration is based on Typesafe SSLConfig.

For convenience, a table of contents to SSLConfig is provided:

• Quick Start to WS SSL
• Generating X.509 Certificates
• Configuring Trust Stores and Key Stores
• Configuring Protocols
• Configuring Cipher Suites
• Configuring Certificate Validation
• Configuring Certificate Revocation
• Configuring Hostname Verification
• Example Configurations
• Using the Default SSLContext
• Debugging SSL Connections
• Loose Options
• Testing SSL

NOTE: The links below are relative to Typesafe SSLConfig, which uses the ssl-config as a prefix for ssl properties.

Play uses the play.ws.ssl prefix, so that, for instance the ssl-config.loose.acceptAnyCertificate becomes play.ws.ssl.loose.acceptAnyCertificate for your play WSClient configuration.

§Further Reading

JSSE is a complex product. For convenience, the JSSE materials are provided here:

JDK 11:

• JSSE Reference Guide
• JSSE Crypto Spec
• SunJSSE Providers
• PKI Programmer’s Guide
• keytool

Next: Configuring WS Cache

Found an error in this documentation? The source code for this page can be found here. After reading the documentation guidelines, please feel free to contribute a pull request. Have questions or advice to share? Go to our community forums to start a conversation with the community.