Go to main content

Guía de la API de RESTful de Oracle® ZFS Storage Appliance (versión OS8.8.x)

Salir de la Vista de impresión

Actualización: Agosto de 2021
 
 

Mostrar certificados

En la siguiente solicitud, se muestran las propiedades de todos los certificados de sistema en el host y se muestra el valor de la propiedad default.

Ejemplo de solicitud:

GET /api/setting/v2/certificates/system HTTP/1.1
Host: alice.example.com:215
Authorization: Basic Tm8gcGVla2luZyE=
Accept: application/json

Resultado de ejemplo:

El primer certificado del siguiente ejemplo es un certificado generado automáticamente convencional (basado en el dominio o la dirección IP). El segundo certificado es un certificado generado automáticamente basado en el UUID de número de serie de dispositivo (ASN).

Al final de este resultado, el valor de la propiedad default muestra que el certificado por defecto de sistema se selecciona automáticamente.

HTTP/1.1 200 OK
Date: Sat, 08 May 2021 00:37:21 GMT
Content-Type: application/json; charset=utf-8
X-Zfssa-Api-Version: 2.0
X-Zfssa-Setting-Api: 2.0
Content-Length: 1975

{
    "certificates": [
        {
            "uuid": "system-cert1-uuid",
            "type": "cert",
            "data": {
                "subject": [
                    {
                        "countryName": "US"
                    },
                    {
                        "stateOrProvinceName": "CA"
                    },
                    {
                        "localityName": "Exampleton"
                    },
                    {
                        "organizationName": "Example Corp, Inc"
                    },
                    {
                        "commonName": "alice.example.com"
                    }
                ],
                "issuer": [
                    {
                        "countryName": "US"
                    },
                    {
                        "stateOrProvinceName": "AK"
                    },
                    {
                        "localityName": "Trustville"
                    },
                    {
                        "organizationName": "Totally Trustworthy Certificates, Inc"
                    },
                    {
                        "commonName": "Most Trusted Certificate"
                    }
                ],
                "serialNumber": "64",
                "validity": {
                    "notBefore": "20210520T21:08:27",
                    "notAfter": "20220520T21:08:27"
                },
                "extensions": {
                    "basicConstraints": {
                        "value": [
                            {
                                "CA": false
                            }
                        ]
                    },
                    "subjectKeyIdentifier": {
                        "value": "subjectKeyIdentifier"
                    },
                    "authorityKeyIdentifier": {
                        "value": [
                            {
                                "keyid": "authorityKeyIdentifier"
                            }
                        ]
                    },
                    "subjectAltName": {
                        "value": [
                            {
                                "DNS": "alice.example.com"
                            },
                            {
                                "IP": "alice.example.com-ipaddr"
                            }
                        ]
                    }
                }
            },
            "sha1fingerprint": "sha1fingerprint",
            "href": "/api/setting/v2/certificates/system/system-cert1-uuid"
        },
        {
            "uuid": "system-cert2-uuid",
            "type": "cert",
            "asn": "8bf7f9bc-8b3a-4064-e59f-bf09e3dba275",
            "data": {
                "subject": [
                    {
                        "commonName": "8bf7f9bc-8b3a-4064-e59f-bf09e3dba275"
                    }
                ],
                "issuer": [
                    {
                        "commonName": "8bf7f9bc-8b3a-4064-e59f-bf09e3dba275"
                    }
                ],
                "serialNumber": "59:8A:73:7B:00:00:00:07",
                "validity": {
                    "notBefore": "20060215T18:00:00",
                    "notAfter": "20380119T03:14:07"
                },
                "extensions": {
                    "nsComment": {
                        "value": "Automatically generated"
                    },
                    "subjectAltName": {
                        "critical": true,
                        "value": [
                            {
                                "DirName": "8bf7f9bc-8b3a-4064-e59f-bf09e3dba275"
                            }
                        ]
                    }
                }
            },
            "sha1fingerprint": "sha1fingerprint",
            "href": "/api/setting/v2/certificates/system/system-cert2-uuid"
        }
    ],
    "default": "auto"
}

La siguiente solicitud muestra las propiedades del certificado de confianza especificado trusted-cert1-uuid.

Ejemplo de solicitud:

GET /api/setting/v2/certificates/trusted/trusted-cert1-uuid HTTP/1.1
Host: alice.example.com:215
Authorization: Basic Tm8gcGVla2luZyE=
Accept: application/json

Resultado de ejemplo:

HTTP/1.1 200 OK
Date: Sat, 08 May 2021 00:37:57 GMT
Content-Length: 984
Content-Type: application/json; charset=utf-8
X-Zfssa-Setting-Api: 2.0
X-Zfssa-Api-Version: 2.0

{
    "certificate": {
        "uuid": "trusted-cert1-uuid",
        "type": "cert_ca",
        "data": {
            "subject": [
                {
                    "countryName": "US"
                },
                {
                    "stateOrProvinceName": "AK"
                },
                {
                    "localityName": "Trustville"
                },
                {
                    "organizationName": "Totally Trustworthy Certificates, Inc"
                },
                {
                    "commonName": "Most Trusted Certificate"
                }
            ],
            "issuer": [
                {
                    "countryName": "US"
                },
                {
                    "stateOrProvinceName": "AK"
                },
                {
                    "localityName": "Trustville"
                },
                {
                    "organizationName": "Totally Trustworthy Certificates, Inc"
                },
                {
                    "commonName": "Most Trusted Certificate"
                }
            ],
            "serialNumber": "83:F7:79:02:5F:44:4D:60",
            "validity": {
                "notBefore": "20210316T17:28:37",
                "notAfter": "20210415T17:28:37"
            },
            "extensions": {
                "subjectKeyIdentifier": {
                    "value": "subjectKeyIdentifier"
                },
                "authorityKeyIdentifier": {
                    "value": [
                        {
                            "keyid": "authorityKeyIdentifier"
                        }
                    ]
                },
                "basicConstraints": {
                    "value": [
                        {
                            "CA": true
                        }
                    ]
                }
            }
        },
        "sha1fingerprint": "sha1fingerprint",
        "services": [
            "ldap",
            "cloud"
        ],
        "href": "/api/setting/v2/certificates/trusted/trusted-cert1-uuid"
    }
}