1 /** 2 * \file doc_x509.h 3 * 4 * \brief X.509 module documentation file. 5 */ 6 /* 7 * 8 * Copyright The Mbed TLS Contributors 9 * SPDX-License-Identifier: Apache-2.0 10 * 11 * Licensed under the Apache License, Version 2.0 (the "License"); you may 12 * not use this file except in compliance with the License. 13 * You may obtain a copy of the License at 14 * 15 * http://www.apache.org/licenses/LICENSE-2.0 16 * 17 * Unless required by applicable law or agreed to in writing, software 18 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT 19 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 20 * See the License for the specific language governing permissions and 21 * limitations under the License. 22 */ 23 24 /** 25 * @addtogroup x509_module X.509 module 26 * 27 * The X.509 module provides X.509 support for reading, writing and verification 28 * of certificates. 29 * In summary: 30 * - X.509 certificate (CRT) reading (see \c mbedtls_x509_crt_parse(), 31 * \c mbedtls_x509_crt_parse_der(), \c mbedtls_x509_crt_parse_file()). 32 * - X.509 certificate revocation list (CRL) reading (see 33 * \c mbedtls_x509_crl_parse(), \c mbedtls_x509_crl_parse_der(), 34 * and \c mbedtls_x509_crl_parse_file()). 35 * - X.509 certificate signature verification (see \c 36 * mbedtls_x509_crt_verify() and \c mbedtls_x509_crt_verify_with_profile(). 37 * - X.509 certificate writing and certificate request writing (see 38 * \c mbedtls_x509write_crt_der() and \c mbedtls_x509write_csr_der()). 39 * 40 * This module can be used to build a certificate authority (CA) chain and 41 * verify its signature. It is also used to generate Certificate Signing 42 * Requests and X.509 certificates just as a CA would do. 43 */ 44