com.microsoft.sqlserver.jdbc.SQLServerColumnEncryptionKeyStoreProvider Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of mssql-jdbc Show documentation

Microsoft JDBC Driver for SQL Server. The Azure Key Vault feature in Microsoft JDBC Driver for SQL Server depends on Azure SDK for JAVA and Azure Active Directory Library For Java.

There is a newer version: 12.7.0.jre11-preview

Show newest version

/*
 * Microsoft JDBC Driver for SQL Server
 * 
 * Copyright(c) Microsoft Corporation All rights reserved.
 * 
 * This program is made available under the terms of the MIT License. See the LICENSE file in the project root for more information.
 */

package com.microsoft.sqlserver.jdbc;

/**
 * 
 * Extend this class to implement a custom key store provider.
 *
 */
public abstract class SQLServerColumnEncryptionKeyStoreProvider {

    /**
     * Sets the name of this key store provider.
     * 
     * @param name
     *            value to be set for the key store provider.
     */
    public abstract void setName(String name);

    /**
     * Retrieves the name of this key store provider.
     * 
     * @return the name of this key store provider.
     */
    public abstract String getName();

    /**
     * Base class method for decrypting the specified encrypted value of a column encryption key. The encrypted value is expected to be encrypted
     * using the column master key with the specified key path and using the specified algorithm.
     * 
     * @param masterKeyPath
     *            The column master key path.
     * @param encryptionAlgorithm
     *            the specific encryption algorithm.
     * @param encryptedColumnEncryptionKey
     *            the encrypted column encryption key
     * @return the decrypted value of column encryption key.
     * @throws SQLServerException
     *             when an error occurs while decrypting the CEK
     */
    public abstract byte[] decryptColumnEncryptionKey(String masterKeyPath,
            String encryptionAlgorithm,
            byte[] encryptedColumnEncryptionKey) throws SQLServerException;

    /**
     * Base class method for encrypting a column encryption key using the column master key with the specified key path and using the specified
     * algorithm.
     * 
     * @param masterKeyPath
     *            The column master key path.
     * @param encryptionAlgorithm
     *            the specific encryption algorithm.
     * @param columnEncryptionKey
     *            column encryption key to be encrypted.
     * @return the encrypted column encryption key.
     * @throws SQLServerException
     *             when an error occurs while encrypting the CEK
     */
    public abstract byte[] encryptColumnEncryptionKey(String masterKeyPath,
            String encryptionAlgorithm,
            byte[] columnEncryptionKey) throws SQLServerException;

}