<!--- Copyright (C) from 2022 The Play Framework Contributors <https://github.com/playframework>, 2011-2021 Lightbend Inc. <https://www.lightbend.com> -->

Configuring WS SSL

[[Play WS|ScalaWS]] 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 17:

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