/*
 * JBoss, Home of Professional Open Source.
 * Copyright 2014 Red Hat, Inc., and individual contributors
 * as indicated by the @author tags.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 */

package io.undertow.servlet.handlers.security;

import java.security.cert.Certificate;
import java.security.cert.X509Certificate;
import javax.servlet.ServletRequest;

import io.undertow.server.HttpHandler;
import io.undertow.server.HttpServerExchange;
import io.undertow.server.SSLSessionInfo;
import io.undertow.servlet.handlers.ServletRequestContext;
import io.undertow.util.HexConverter;

Handler that associates SSL metadata with request

cipher suite - javax.servlet.request.cipher_suite String bit size of the algorithm - javax.servlet.request.key_size Integer SSL session id - javax.servlet.request.ssl_session_id String

Author:Tomaz Cerar (c) 2013 Red Hat Inc.
/** * Handler that associates SSL metadata with request * <p> * cipher suite - javax.servlet.request.cipher_suite String * bit size of the algorithm - javax.servlet.request.key_size Integer * SSL session id - javax.servlet.request.ssl_session_id String * * @author <a href="mailto:tomaz.cerar@redhat.com">Tomaz Cerar</a> (c) 2013 Red Hat Inc. */
public class SSLInformationAssociationHandler implements HttpHandler { private final HttpHandler next; public SSLInformationAssociationHandler(final HttpHandler next) { this.next = next; }
Given the name of a TLS/SSL cipher suite, return an int representing it effective stream cipher key strength. i.e. How much entropy material is in the key material being fed into the encryption routines.

http://www.thesprawl.org/research/tls-and-ssl-cipher-suites/

Params:
  • cipherSuite – String name of the TLS cipher suite.
Returns:int indicating the effective key entropy bit-length.
/** * Given the name of a TLS/SSL cipher suite, return an int representing it effective stream * cipher key strength. i.e. How much entropy material is in the key material being fed into the * encryption routines. * <p> * http://www.thesprawl.org/research/tls-and-ssl-cipher-suites/ * </p> * * @param cipherSuite String name of the TLS cipher suite. * @return int indicating the effective key entropy bit-length. */
public static int getKeyLength(String cipherSuite) { return SSLSessionInfo.calculateKeySize(cipherSuite); } /* ------------------------------------------------------------ */
Return the chain of X509 certificates used to negotiate the SSL Session.
Params:
  • session – the javax.net.ssl.SSLSession to use as the source of the cert chain.
Returns:the chain of java.security.cert.X509Certificates used to negotiate the SSL connection.
Will be null if the chain is missing or empty.
/** * Return the chain of X509 certificates used to negotiate the SSL Session. * * @param session the javax.net.ssl.SSLSession to use as the source of the cert chain. * @return the chain of java.security.cert.X509Certificates used to * negotiate the SSL connection. <br> * Will be null if the chain is missing or empty. */
private X509Certificate[] getCerts(SSLSessionInfo session) { try { Certificate[] javaCerts = session.getPeerCertificates(); if (javaCerts == null) { return null; } int x509Certs = 0; for (Certificate javaCert : javaCerts) { if (javaCert instanceof X509Certificate) { ++x509Certs; } } if (x509Certs == 0) { return null; } int resultIndex = 0; X509Certificate[] results = new X509Certificate[x509Certs]; for (Certificate certificate : javaCerts) { if (certificate instanceof X509Certificate) { results[resultIndex++] = (X509Certificate) certificate; } } return results; } catch (Exception e) { return null; } } @Override public void handleRequest(HttpServerExchange exchange) throws Exception { ServletRequest request = exchange.getAttachment(ServletRequestContext.ATTACHMENT_KEY).getServletRequest(); SSLSessionInfo ssl = exchange.getConnection().getSslSessionInfo(); if (ssl != null) { String cipherSuite = ssl.getCipherSuite(); byte[] sessionId = ssl.getSessionId(); request.setAttribute("javax.servlet.request.cipher_suite", cipherSuite); request.setAttribute("javax.servlet.request.key_size", ssl.getKeySize()); request.setAttribute("javax.servlet.request.ssl_session_id", sessionId != null? HexConverter.convertToHexString(sessionId) : null); X509Certificate[] certs = getCerts(ssl); if (certs != null) { request.setAttribute("javax.servlet.request.X509Certificate", certs); } } next.handleRequest(exchange); } }