Files
authentik/website/docs/developer-docs/api/reference/crypto-certificatekeypairs-list.api.mdx
Tana M Berry 7a6d44d0df first pass
2024-10-22 15:10:13 -05:00

611 lines
26 KiB
Plaintext

---
id: crypto-certificatekeypairs-list
title: "crypto_certificatekeypairs_list"
description: "CertificateKeyPair Viewset"
sidebar_label: "crypto_certificatekeypairs_list"
hide_title: true
hide_table_of_contents: true
api: eJytWG1v2zYQ/iuEvmwDPKtN02HIpwVF0AZ9WdC0HYYiEGjpZLGhSZWknHiB//vuSCmiLdmJ036yJR3vee54b+Rdomsw3AmtzovkJMnNqnY6y8E4UYqcO7iGVc2FsZkU1iWTpACbG1HTCpR/1Qu+hdUFCrIvAm4skGjNDV+AA2OTk693iaAF3xswK/ym8As+VtxmiIAvbF7Bgicnd4lb1fRpprUErpL1NubfSq6YAdcYxSKiv6Me5qmyG+Eqho8WF4/jCpXLpoCsAMeFtPvwCb7kjXTJiTMNrHepXHDF51CMqbLOCDVPdi71Pw+sa0W1KcC/nCQGvjfCIOJJyaWFyabqTZ/9U4m8YqUAWTCnWWOB3VSgWKeOuQrQpxbNtNNHUqnR3ANpnDJaxFSzmIHx2ySUh8bXQuEmFi0JhhE0ykMoB3MwAyKZFf8dyuZDoKHLznJyTRtYmBWe66NJWOAmrw72R1jGMEkW+/1+NUkcn1MmtUma4BsLeWOEW/n84g16UjlxjU9XJI9W1VpZsKTv6Nkz+sk1cleO/vK6lpQ5SCX9ZonP3RBfz75B7pPZUKVwImhr90uEVftlFdy6SCpsPqV1bWApdGNHP+a6UePL0GQDO7457bjMaOPGtVrHjcuEKuB29DuoYufXdby3X4NZkREd5Z7gJp1N8BiKtlY4SVgXvV89nA/LiAs3hlMYCQcLO+b6B8vzJeY7l5gsZrip18PAmySlNguO3k6aRhQ+vnlBJTiUw57625p5iXVX1gYxjLrwF0yNjy6zFT96+ccYomqk5DNSGhA2bXoNLi777A23Ffv18s0pavttwG8I+vwnQj4fBSTRDG5rgRm/z6EFdS0nfO0/jECrfBe2bUI4/LChrSLGLStxITNlfvzy+fEYMPp3iUuom2d8iU01oIy20xjystI3TJTYBYRl7bDBcCxgnLUq6S3DulWKeYO5hz2LKe0e4hBgn+IA34966F+wLaCOCZEMc82o01uXZYW+UVLzImuMHMMf4n3++I4aT7cw3oCHjPxxsMjQMbBuqBnRvV0Hth3b1YX3QQWbrVjfoQYznY8z9HTFMdoMsMXIqin7VAFOLroVJrkcadDYwFXBmroI/xunMcPQg1KuaBFGVin5nGmaHLHmet92YKrVx3L8O0PtSzA32FSxTRL6QszDfGyn7F/deCnrBCbDQheiXPlw6RgtBffPpxfnEzZrHCWqV11xrEF+vthCwPmHM4l0TEt/Omg0cTnZSvA9oTdS90br7yQaXNs5tL5OduXznvAbSb+osQ07Edq5ZWg0VPS9b9gcoRgqe0eHE69wM66o6Rz/4OSzqfELNs/CL2VnxuhhF1VaZX7QzoC+P6Z798M1sizGWid+4UUhCJbLixhv3funpxaY7fTHi5/oj9egcKLIKeR3OCScsUbngd3WxnHRKogioQXdYybVLnCVpkPtvD2Nugof0jA9pyNH3JRmNDDL7sDqi2qS8lqkyxdpso4G7kvyTjAvGrvvDamcq7tp3jc/nPLbEVKoUnvJ1pS4JhJyMODo2dHx9M/p0cDd7/k1Hde6VWHTmBWLWvqzCu0qD60ft4/cnlQgpf5rrvs6KjQ5H7cc8HTgYzacYd6ff0IVwWwywZ6k6RwPac1smutFGqlI+38zqWcpQqn03fmrsw+XZ97MWluHhSVSHvzORvzOxq4WogDdf8vQutzhOJ7WEnmQbW0/DHt+f2LaKJcdOr6l0KqQMIne3c24hc9Grtf0OpzbKBoKYakE9ue6nXQPuaDYwZ/acXw7suSygZC/I0yC9PBO4zGr+ur/GOm2Q+wX3emYQ28h9rgmugd5IpmD7yL2sGmvQp7I5LH3EA8Q6K5AnuyPrbuIPXD3lx091hU94NHST4Bfr1C0wgERix7lTlh1mudQu2jVoO+Qlvuy/fqMqhEVmvgYESrppPtD2rvuquJMwTz2Ep/0NSjM5Y66o2cEwq7xPwmsUOY=
sidebar_class_name: "get api-method"
info_path: docs/developer-docs/api/reference/authentik
custom_edit_url: null
hide_send_button: true
---
import ApiTabs from "@theme/ApiTabs";
import DiscriminatorTabs from "@theme/DiscriminatorTabs";
import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import SecuritySchemes from "@theme/ApiExplorer/SecuritySchemes";
import MimeTabs from "@theme/MimeTabs";
import ParamsItem from "@theme/ParamsItem";
import ResponseSamples from "@theme/ResponseSamples";
import SchemaItem from "@theme/SchemaItem";
import SchemaTabs from "@theme/SchemaTabs";
import Heading from "@theme/Heading";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
<Heading
as={"h1"}
className={"openapi__heading"}
children={"crypto_certificatekeypairs_list"}
>
</Heading>
<MethodEndpoint
method={"get"}
path={"/crypto/certificatekeypairs/"}
>
</MethodEndpoint>
CertificateKeyPair Viewset
<Heading
id={"request"}
as={"h2"}
className={"openapi-tabs__heading"}
children={"Request"}
>
</Heading>
<details
style={{"marginBottom":"1rem"}}
className={"openapi-markdown__details"}
data-collapsed={false}
open={true}
>
<summary
style={{}}
>
<h3
className={"openapi-markdown__details-summary-header-params"}
>
Query Parameters
</h3>
</summary><div>
<ul>
<ParamsItem
className={"paramsItem"}
param={{"in":"query","name":"has_key","schema":{"type":"boolean"},"description":"Only return certificate-key pairs with keys"}}
>
</ParamsItem><ParamsItem
className={"paramsItem"}
param={{"in":"query","name":"include_details","schema":{"type":"boolean","default":true}}}
>
</ParamsItem><ParamsItem
className={"paramsItem"}
param={{"in":"query","name":"managed","schema":{"type":"string"}}}
>
</ParamsItem><ParamsItem
className={"paramsItem"}
param={{"in":"query","name":"name","schema":{"type":"string"}}}
>
</ParamsItem><ParamsItem
className={"paramsItem"}
param={{"name":"ordering","required":false,"in":"query","description":"Which field to use when ordering the results.","schema":{"type":"string"}}}
>
</ParamsItem><ParamsItem
className={"paramsItem"}
param={{"name":"page","required":false,"in":"query","description":"A page number within the paginated result set.","schema":{"type":"integer"}}}
>
</ParamsItem><ParamsItem
className={"paramsItem"}
param={{"name":"page_size","required":false,"in":"query","description":"Number of results to return per page.","schema":{"type":"integer"}}}
>
</ParamsItem><ParamsItem
className={"paramsItem"}
param={{"name":"search","required":false,"in":"query","description":"A search term.","schema":{"type":"string"}}}
>
</ParamsItem>
</ul>
</div>
</details><div>
<div>
<ApiTabs
label={undefined}
id={undefined}
>
<TabItem
label={"200"}
value={"200"}
>
<div>
</div><div>
<MimeTabs
className={"openapi-tabs__mime"}
schemaType={"response"}
>
<TabItem
label={"application/json"}
value={"application/json"}
>
<SchemaTabs
className={"openapi-tabs__schema"}
>
<TabItem
label={"Schema"}
value={"Schema"}
>
<details
style={{}}
className={"openapi-markdown__details response"}
data-collapsed={false}
open={true}
>
<summary
style={{}}
className={"openapi-markdown__details-summary-response"}
>
<strong>
Schema
</strong>
</summary><div
style={{"textAlign":"left","marginLeft":"1rem"}}
>
</div><ul
style={{"marginLeft":"1rem"}}
>
<SchemaItem
collapsible={true}
className={"schemaItem"}
>
<details
style={{}}
className={"openapi-markdown__details"}
>
<summary
style={{}}
>
<span
className={"openapi-schema__container"}
>
<strong
className={"openapi-schema__property"}
>
pagination
</strong><span
className={"openapi-schema__name"}
>
object
</span><span
className={"openapi-schema__divider"}
>
</span><span
className={"openapi-schema__required"}
>
required
</span>
</span>
</summary><div
style={{"marginLeft":"1rem"}}
>
<SchemaItem
collapsible={false}
name={"next"}
required={true}
schemaName={"number"}
qualifierMessage={undefined}
schema={{"type":"number"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"previous"}
required={true}
schemaName={"number"}
qualifierMessage={undefined}
schema={{"type":"number"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"count"}
required={true}
schemaName={"number"}
qualifierMessage={undefined}
schema={{"type":"number"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"current"}
required={true}
schemaName={"number"}
qualifierMessage={undefined}
schema={{"type":"number"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"total_pages"}
required={true}
schemaName={"number"}
qualifierMessage={undefined}
schema={{"type":"number"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"start_index"}
required={true}
schemaName={"number"}
qualifierMessage={undefined}
schema={{"type":"number"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"end_index"}
required={true}
schemaName={"number"}
qualifierMessage={undefined}
schema={{"type":"number"}}
>
</SchemaItem>
</div>
</details>
</SchemaItem><SchemaItem
collapsible={true}
className={"schemaItem"}
>
<details
style={{}}
className={"openapi-markdown__details"}
>
<summary
style={{}}
>
<span
className={"openapi-schema__container"}
>
<strong
className={"openapi-schema__property"}
>
results
</strong><span
className={"openapi-schema__name"}
>
object[]
</span><span
className={"openapi-schema__divider"}
>
</span><span
className={"openapi-schema__required"}
>
required
</span>
</span>
</summary><div
style={{"marginLeft":"1rem"}}
>
<li>
<div
style={{"fontSize":"var(--ifm-code-font-size)","opacity":"0.6","marginLeft":"-.5rem","paddingBottom":".5rem"}}
>
Array [
</div>
</li><SchemaItem
collapsible={false}
name={"pk"}
required={true}
schemaName={"uuid"}
qualifierMessage={undefined}
schema={{"type":"string","format":"uuid","readOnly":true,"title":"Kp uuid"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"name"}
required={true}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"fingerprint_sha256"}
required={true}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string","nullable":true,"description":"Get certificate Hash (SHA256)","readOnly":true}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"fingerprint_sha1"}
required={true}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string","nullable":true,"description":"Get certificate Hash (SHA1)","readOnly":true}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"cert_expiry"}
required={true}
schemaName={"date-time"}
qualifierMessage={undefined}
schema={{"type":"string","format":"date-time","nullable":true,"description":"Get certificate expiry","readOnly":true}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"cert_subject"}
required={true}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string","nullable":true,"description":"Get certificate subject as full rfc4514","readOnly":true}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"private_key_available"}
required={true}
schemaName={"boolean"}
qualifierMessage={undefined}
schema={{"type":"boolean","description":"Show if this keypair has a private key configured or not","readOnly":true}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"private_key_type"}
required={true}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string","nullable":true,"description":"Get the private key's type, if set","readOnly":true}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"certificate_download_url"}
required={true}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string","description":"Get URL to download certificate","readOnly":true}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"private_key_download_url"}
required={true}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string","description":"Get URL to download private key","readOnly":true}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"managed"}
required={true}
schemaName={"Managed by authentik (string)"}
qualifierMessage={undefined}
schema={{"type":"string","readOnly":true,"nullable":true,"title":"Managed by authentik","description":"Objects that are managed by authentik. These objects are created and updated automatically. This flag only indicates that an object can be overwritten by migrations. You can still modify the objects via the API, but expect changes to be overwritten in a later update."}}
>
</SchemaItem><li>
<div
style={{"fontSize":"var(--ifm-code-font-size)","opacity":"0.6","marginLeft":"-.5rem"}}
>
]
</div>
</li>
</div>
</details>
</SchemaItem>
</ul>
</details>
</TabItem><TabItem
label={"Example (from schema)"}
value={"Example (from schema)"}
>
<ResponseSamples
responseExample={"{\n \"pagination\": {\n \"next\": 0,\n \"previous\": 0,\n \"count\": 0,\n \"current\": 0,\n \"total_pages\": 0,\n \"start_index\": 0,\n \"end_index\": 0\n },\n \"results\": [\n {\n \"pk\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"name\": \"string\",\n \"fingerprint_sha256\": \"string\",\n \"fingerprint_sha1\": \"string\",\n \"cert_expiry\": \"2024-07-29T15:51:28.071Z\",\n \"cert_subject\": \"string\",\n \"private_key_available\": true,\n \"private_key_type\": \"string\",\n \"certificate_download_url\": \"string\",\n \"private_key_download_url\": \"string\",\n \"managed\": \"string\"\n }\n ]\n}"}
language={"json"}
>
</ResponseSamples>
</TabItem>
</SchemaTabs>
</TabItem>
</MimeTabs>
</div>
</TabItem><TabItem
label={"400"}
value={"400"}
>
<div>
</div><div>
<MimeTabs
className={"openapi-tabs__mime"}
schemaType={"response"}
>
<TabItem
label={"application/json"}
value={"application/json"}
>
<SchemaTabs
className={"openapi-tabs__schema"}
>
<TabItem
label={"Schema"}
value={"Schema"}
>
<details
style={{}}
className={"openapi-markdown__details response"}
data-collapsed={false}
open={true}
>
<summary
style={{}}
className={"openapi-markdown__details-summary-response"}
>
<strong>
Schema
</strong>
</summary><div
style={{"textAlign":"left","marginLeft":"1rem"}}
>
</div><ul
style={{"marginLeft":"1rem"}}
>
<SchemaItem
collapsible={false}
name={"non_field_errors"}
required={false}
schemaName={"string[]"}
qualifierMessage={undefined}
schema={{"type":"array","items":{"type":"string"}}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"code"}
required={false}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string"}}
>
</SchemaItem><SchemaItem
name={"property name*"}
required={false}
schemaName={"any"}
qualifierMessage={undefined}
schema={{"type":"object","description":"Validation Error","properties":{"non_field_errors":{"type":"array","items":{"type":"string"}},"code":{"type":"string"}},"additionalProperties":{},"title":"ValidationError"}}
collapsible={false}
discriminator={false}
>
</SchemaItem>
</ul>
</details>
</TabItem><TabItem
label={"Example (from schema)"}
value={"Example (from schema)"}
>
<ResponseSamples
responseExample={"{\n \"non_field_errors\": [\n \"string\"\n ],\n \"code\": \"string\"\n}"}
language={"json"}
>
</ResponseSamples>
</TabItem>
</SchemaTabs>
</TabItem>
</MimeTabs>
</div>
</TabItem><TabItem
label={"403"}
value={"403"}
>
<div>
</div><div>
<MimeTabs
className={"openapi-tabs__mime"}
schemaType={"response"}
>
<TabItem
label={"application/json"}
value={"application/json"}
>
<SchemaTabs
className={"openapi-tabs__schema"}
>
<TabItem
label={"Schema"}
value={"Schema"}
>
<details
style={{}}
className={"openapi-markdown__details response"}
data-collapsed={false}
open={true}
>
<summary
style={{}}
className={"openapi-markdown__details-summary-response"}
>
<strong>
Schema
</strong>
</summary><div
style={{"textAlign":"left","marginLeft":"1rem"}}
>
</div><ul
style={{"marginLeft":"1rem"}}
>
<SchemaItem
collapsible={false}
name={"detail"}
required={true}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"code"}
required={false}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string"}}
>
</SchemaItem>
</ul>
</details>
</TabItem><TabItem
label={"Example (from schema)"}
value={"Example (from schema)"}
>
<ResponseSamples
responseExample={"{\n \"detail\": \"string\",\n \"code\": \"string\"\n}"}
language={"json"}
>
</ResponseSamples>
</TabItem>
</SchemaTabs>
</TabItem>
</MimeTabs>
</div>
</TabItem>
</ApiTabs>
</div>
</div>