fleet/frontend/interfaces/certificates.ts
jacobshandling 50e7947b67
Update Add, Edit, and Delete Certificate Authority modals to support Custom EST (#35085)
**Related issue:** Resolves #34276 

<img width="1241" height="924" alt="Screenshot 2025-10-31 at 5 21 57 PM"
src="https://github.com/user-attachments/assets/44d94842-c4d0-4770-9072-6a87da2ae6cb"
/>


![ezgif-6f70f761e3ad5b](https://github.com/user-attachments/assets/606a4696-7fc2-409f-a047-6436f1916899)


- [x] Changes file added for user-visible changes in `changes/`
- [x] Added/updated automated tests
- [x] QA'd all new/changed functionality manually
2025-11-04 15:06:07 -08:00

180 lines
4 KiB
TypeScript

import { IListSort } from "./list_options";
export interface IHostCertificate {
id: number;
not_valid_after: string;
not_valid_before: string;
certificate_authority: boolean;
common_name: string;
key_algorithm: string;
key_strength: number;
key_usage: string;
serial: string;
signing_algorithm: string;
subject: {
country: string;
organization: string;
organizational_unit: string;
common_name: string;
};
issuer: {
country: string;
organization: string;
organizational_unit: string;
common_name: string;
};
source: string;
username: string;
}
export const CERTIFICATES_DEFAULT_SORT: IListSort = {
order_key: "common_name",
order_direction: "asc",
} as const;
/** This interface represent the smaller subset of cert authority data that is
returned for some of the cert authority endpoints */
export interface ICertificateAuthorityPartial {
id: number;
name: string;
type: ICertificateAuthorityType;
}
export interface ICertificatesNDES {
id?: number;
type?: "ndes_scep_proxy";
url: string;
admin_url: string;
username: string;
password: string;
}
export interface ICertificatesDigicert {
id?: number;
type?: "digicert";
name: string;
url: string;
api_token: string;
profile_id: string;
certificate_common_name: string;
certificate_user_principal_names: string[] | null;
certificate_seat_id: string;
}
export interface ICertificatesHydrant {
id?: number;
type?: "hydrant";
name: string;
url: string;
client_id: string;
client_secret: string;
}
export interface ICertificatesCustomSCEP {
id?: number;
type?: "custom_scep_proxy";
name: string;
url: string;
challenge: string;
}
export interface ICertificatesSmallstep {
id?: number;
type?: "smallstep";
name: string;
url: string;
challenge_url: string;
username: string;
password: string;
}
export interface ICertificatesCustomEST {
id?: number;
type?: "custom_est_proxy";
name: string;
url: string;
username: string;
password: string;
}
export type ICertificateAuthorityType =
| "ndes_scep_proxy"
| "digicert"
| "custom_scep_proxy"
| "hydrant"
| "smallstep"
| "custom_est_proxy";
/** all the types of certificates */
export type ICertificateAuthority =
| ICertificatesNDES
| ICertificatesDigicert
| ICertificatesHydrant
| ICertificatesCustomSCEP
| ICertificatesSmallstep
| ICertificatesCustomEST;
export const isNDESCertAuthority = (
integration: ICertificateAuthority
): integration is ICertificatesNDES => {
return (
"admin_url" in integration &&
"username" in integration &&
"password" in integration
);
};
export const isDigicertCertAuthority = (
integration: ICertificateAuthority
): integration is ICertificatesDigicert => {
return (
"profile_id" in integration &&
"certificate_common_name" in integration &&
"certificate_user_principal_names" in integration &&
"certificate_seat_id" in integration
);
};
export const isHydrantCertAuthority = (
integration: ICertificateAuthority
): integration is ICertificatesHydrant => {
return (
"name" in integration &&
"url" in integration &&
"client_id" in integration &&
"client_secret" in integration
);
};
export const isCustomSCEPCertAuthority = (
integration: ICertificateAuthority
): integration is ICertificatesCustomSCEP => {
return (
"name" in integration && "url" in integration && "challenge" in integration
);
};
export const isSmallstepCertAuthority = (
integration: ICertificateAuthority
): integration is ICertificatesSmallstep => {
return (
"name" in integration &&
"url" in integration &&
"challenge_url" in integration &&
"username" in integration &&
"password" in integration
);
};
export const isCustomESTCertAuthority = (
integration: ICertificateAuthority
): integration is ICertificatesCustomEST => {
return (
"name" in integration &&
"url" in integration &&
// differentiates from smallstep
!("challenge_url" in integration) &&
"username" in integration &&
"password" in integration
);
};