/*
 * Copyright 2014
 *
 * 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 com.digitalpetri.opcua.stack.core.application;

import java.security.KeyPair;
import java.security.cert.X509Certificate;
import java.util.Optional;
import java.util.Set;

import com.digitalpetri.opcua.stack.core.types.builtin.ByteString;

public interface CertificateManager {

    Optional<KeyPair> getKeyPair(ByteString thumbprint);

    Optional<X509Certificate> getCertificate(ByteString thumbprint);

    Set<KeyPair> getKeyPairs();

    Set<X509Certificate> getCertificates();

    Set<X509Certificate> getTrustList();

    Set<X509Certificate> getAuthorityList();

    void certificateRejected(X509Certificate certificate);

}

/*
 * Copyright 2014
 *
 * 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 com.digitalpetri.opcua.stack.core.application;

import java.security.KeyPair;
import java.security.cert.X509Certificate;
import java.util.Optional;
import java.util.Set;

import com.digitalpetri.opcua.stack.core.types.builtin.ByteString;

public interface CertificateManager {

    /**
     * Get the {@link KeyPair} belonging to the certificate identified by {@code thumbprint}.
     * <p>
     * {@code thumbprint} is a SHA1 hash of the encoded certificate.
     *
     * @param thumbprint the thumbprint of the certificate.
     * @return the {@link KeyPair} belonging to the certificate identified by {@code thumbprint}.
     */
    Optional<KeyPair> getKeyPair(ByteString thumbprint);

    /**
     * Get the {@link X509Certificate} identified by {@code thumbprint}.
     * <p>
     * {@code thumbprint} is a SHA1 hash of the encoded certificate.
     *
     * @param thumbprint the thumbprint of the certificate.
     * @return the {@link X509Certificate} identified by {@code thumbprint}.
     */
    Optional<X509Certificate> getCertificate(ByteString thumbprint);

    /**
     * @return the Set of all managed {@link KeyPair}s.
     */
    Set<KeyPair> getKeyPairs();

    /**
     * @return the Set of all managed {@link X509Certificate}s.
     */
    Set<X509Certificate> getCertificates();

    /**
     * @return the Set of trusted {@link X509Certificate}s.
     */
    Set<X509Certificate> getTrustList();

    /**
     * @return the Set of trusted authority {@link X509Certificate}s.
     */
    Set<X509Certificate> getAuthorityList();

    /**
     * Handle a rejected certificate.
     * <p>
     * One course of action is to quarantine it so a user can later move it to the trusted list.
     *
     * @param certificate the rejected {@link X509Certificate}.
     */
    void certificateRejected(X509Certificate certificate);

}

Add Javadoc to CertificateManager