Skip to content

Infisical is the open-source platform for securing secrets, certificates, access, and AI Agents.

feat(ui): dynamic secret oauth

=2e6135ea46c7
diff --git a/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/DynamicSecretProviderForm.tsx b/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/DynamicSecretProviderForm.tsx
index 960cd0ffee..8b55493a62 100644
--- a/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/DynamicSecretProviderForm.tsx
+++ b/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/DynamicSecretProviderForm.tsx
@@ -233,6 +233,9 @@ export const DynamicSecretProviderForm = <
const nameError = form.formState.errors.name;
const defaultTtlError = form.formState.errors.defaultTTL;
const maxTtlError = form.formState.errors.maxTTL;
+ const ttlDescriptionId = commonFields?.ttlDescription
+ ? "dynamic-secret-ttl-description"
+ : undefined;
return (
<FormProvider {...form}>
@@ -299,6 +302,7 @@ export const DynamicSecretProviderForm = <
commonFields?.defaultTTL?.description
? "dynamic-secret-default-ttl-description"
: undefined,
+ ttlDescriptionId,
defaultTtlError ? "dynamic-secret-default-ttl-error" : undefined
]
.filter(Boolean)
@@ -342,6 +346,7 @@ export const DynamicSecretProviderForm = <
commonFields?.maxTTL?.description
? "dynamic-secret-max-ttl-description"
: undefined,
+ ttlDescriptionId,
maxTtlError ? "dynamic-secret-max-ttl-error" : undefined
]
.filter(Boolean)
@@ -364,6 +369,11 @@ export const DynamicSecretProviderForm = <
/>
)}
</div>
+ {ttlDescriptionId && ttlFieldCount > 0 && (
+ <FieldDescription id={ttlDescriptionId}>
+ {commonFields?.ttlDescription}
+ </FieldDescription>
+ )}
{mode === "create" &&
!isSingleEnvironmentMode &&
commonFields?.environment?.isVisible !== false && (
diff --git a/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/oauth-contract.test.ts b/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/oauth-contract.test.ts
new file mode 100644
index 0000000000..e0caa9030a
--- /dev/null
+++ b/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/oauth-contract.test.ts
@@ -0,0 +1,248 @@
+import assert from "node:assert/strict";
+import { describe, it } from "vitest";
+
+import {
+ DynamicSecretProviders,
+ OAuthClientAuthMethod,
+ OAuthGrantType
+} from "@app/hooks/api/dynamicSecret/types";
+
+import {
+ getOAuthCreateDefaultValues,
+ getOAuthCreatePayload,
+ getOAuthEditDefaultValues,
+ getOAuthEditPayload,
+ OAUTH_CUSTOM_RENDERER_REASONS,
+ oauthCreateFormSchema,
+ oauthEditFormSchema
+} from "./providerDefinitions/oauthContract";
+import { testDynamicSecretProviderContract } from "./providerContractTestHarness";
+import type {
+ TCreateDynamicSecretProviderFormContext,
+ TEditDynamicSecretProviderFormContext
+} from "./types";
+import { defineDynamicSecretProvider } from "./types";
+
+const environment = { id: "env-id", name: "Development", slug: "dev", position: 1 };
+const createContext: TCreateDynamicSecretProviderFormContext = {
+ projectSlug: "project",
+ secretPath: "/folder",
+ environments: [environment],
+ isSingleEnvironmentMode: true
+};
+
+const storedInputs = {
+ grantType: OAuthGrantType.ClientCredentials,
+ tokenUrl: "https://auth.example.com/oauth2/token",
+ revocationUrl: "https://auth.example.com/oauth2/revoke",
+ clientId: "client-id",
+ clientAuth: { method: OAuthClientAuthMethod.ClientSecretPost },
+ scope: "read write",
+ extraParams: [{ key: "audience", value: "https://api.example.com" }]
+};
+
+const editContext: TEditDynamicSecretProviderFormContext = {
+ projectSlug: "project",
+ secretPath: "/folder",
+ environment: "dev",
+ dynamicSecret: {
+ id: "dynamic-secret-id",
+ name: "existing-secret",
+ type: DynamicSecretProviders.OAuth,
+ createdAt: "2026-01-01",
+ updatedAt: "2026-01-01",
+ defaultTTL: "30m",
+ maxTTL: "1h",
+ inputs: storedInputs
+ }
+};
+
+const NoopRenderer = () => null;
+
+const oauthDynamicSecretProvider = defineDynamicSecretProvider({
+ provider: DynamicSecretProviders.OAuth,
+ label: "OAuth 2.0",
+ customRenderer: { reasons: OAUTH_CUSTOM_RENDERER_REASONS, Component: NoopRenderer },
+ create: {
+ schema: oauthCreateFormSchema,
+ getDefaultValues: getOAuthCreateDefaultValues,
+ toPayload: getOAuthCreatePayload,
+ submitLabel: "Submit"
+ },
+ edit: {
+ schema: oauthEditFormSchema,
+ getDefaultValues: getOAuthEditDefaultValues,
+ toPayload: getOAuthEditPayload,
+ submitLabel: "Submit",
+ successMessage: "Successfully updated dynamic secret"
+ }
+});
+
+const createDefaults = {
+ name: "",
+ defaultTTL: "30m",
+ maxTTL: "1h",
+ environment,
+ inputs: {
+ grantType: OAuthGrantType.ClientCredentials,
+ tokenUrl: "",
+ revocationUrl: "",
+ clientId: "",
+ clientAuth: { method: OAuthClientAuthMethod.ClientSecretBasic, clientSecret: "" },
+ scope: "",
+ extraParams: []
+ }
+};
+
+const createValues = {
+ ...createDefaults,
+ name: "oauth-secret",
+ inputs: {
+ ...storedInputs,
+ clientAuth: { method: OAuthClientAuthMethod.ClientSecretBasic, clientSecret: "client-secret" },
+ scope: " read write read "
+ }
+};
+
+const editValues = {
+ name: "renamed-oauth-secret",
+ defaultTTL: "30m",
+ maxTTL: "1h",
+ inputs: {
+ ...storedInputs,
+ clientAuth: { method: OAuthClientAuthMethod.ClientSecretPost, clientSecret: "" },
+ scope: ""
+ }
+};
+
+testDynamicSecretProviderContract({
+ name: "OAuth 2.0",
+ definition: oauthDynamicSecretProvider,
+ create: {
+ context: createContext,
+ defaultValues: createDefaults,
+ validValues: createValues,
+ payload: {
+ provider: {
+ type: DynamicSecretProviders.OAuth,
+ inputs: {
+ ...storedInputs,
+ clientAuth: {
+ method: OAuthClientAuthMethod.ClientSecretBasic,
+ clientSecret: "client-secret"
+ },
+ scope: "read write"
+ }
+ },
+ defaultTTL: "30m",
+ maxTTL: "1h",
+ name: "oauth-secret",
+ path: "/folder",
+ projectSlug: "project",
+ environmentSlug: "dev"
+ },
+ invalidValues: [
+ {
+ name: "revocation URL is not a URL",
+ values: { ...createValues, inputs: { ...createValues.inputs, revocationUrl: "revoke" } },
+ issuePaths: [["inputs", "revocationUrl"]]
+ },
+ {
+ name: "client secret is missing",
+ values: {
+ ...createValues,
+ inputs: {
+ ...createValues.inputs,
+ clientAuth: { method: OAuthClientAuthMethod.ClientSecretBasic, clientSecret: "" }
+ }
+ },
+ issuePaths: [["inputs", "clientAuth", "clientSecret"]]
+ },
+ {
+ name: "scope has characters outside RFC 6749",
+ values: { ...createValues, inputs: { ...createValues.inputs, scope: 'read "write"' } },
+ issuePaths: [["inputs", "scope"]]
+ },
+ {
+ name: "extra parameter overrides a reserved parameter",
+ values: {
+ ...createValues,
+ inputs: { ...createValues.inputs, extraParams: [{ key: "client_secret", value: "x" }] }
+ },
+ issuePaths: [["inputs", "extraParams", 0, "key"]]
+ },
+ {
+ name: "extra parameter is repeated",
+ values: {
+ ...createValues,
+ inputs: {
+ ...createValues.inputs,
+ extraParams: [
+ { key: "audience", value: "a" },
+ { key: "audience", value: "b" }
+ ]
+ }
+ },
+ issuePaths: [["inputs", "extraParams", 1, "key"]]
+ }
+ ]
+ },
+ edit: {
+ context: editContext,
+ defaultValues: {
+ name: "existing-secret",
+ defaultTTL: "30m",
+ maxTTL: "1h",
+ inputs: {
+ ...storedInputs,
+ clientAuth: { method: OAuthClientAuthMethod.ClientSecretPost, clientSecret: "" }
+ }
+ },
+ validValues: editValues,
+ payload: {
+ name: "existing-secret",
+ path: "/folder",
+ projectSlug: "project",
+ environmentSlug: "dev",
+ data: {
+ inputs: { ...storedInputs, scope: "" },
+ newName: "renamed-oauth-secret",
+ defaultTTL: "30m",
+ maxTTL: "1h"
+ }
+ }
+ }
+});
+
+type TClientAuthPayload = { clientAuth: { method: string; clientSecret?: string } };
+
+describe("OAuth 2.0 edit payload", () => {
+ it("omits a blank client secret so the stored one is kept", () => {
+ const payload = getOAuthEditPayload(editValues, editContext);
+ const { clientAuth } = payload.data.inputs as TClientAuthPayload;
+ assert.deepEqual(clientAuth, { method: OAuthClientAuthMethod.ClientSecretPost });
+ });
+
+ it("sends a new client secret and auth method when they change", () => {
+ const payload = getOAuthEditPayload(
+ {
+ ...editValues,
+ inputs: {
+ ...editValues.inputs,
+ clientAuth: { method: OAuthClientAuthMethod.ClientSecretBasic, clientSecret: "rotated" }
+ }
+ },
+ editContext
+ );
+ const { clientAuth } = payload.data.inputs as TClientAuthPayload;
+ assert.deepEqual(clientAuth, {
+ method: OAuthClientAuthMethod.ClientSecretBasic,
+ clientSecret: "rotated"
+ });
+ });
+
+ it("hydrates the stored auth method on edit", () => {
+ const defaults = getOAuthEditDefaultValues(editContext);
+ assert.equal(defaults.inputs.clientAuth.method, OAuthClientAuthMethod.ClientSecretPost);
+ });
+});
diff --git a/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/productionRegistry.test.ts b/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/productionRegistry.test.ts
index 7c5f5079a5..90a3ebe583 100644
--- a/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/productionRegistry.test.ts
+++ b/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/productionRegistry.test.ts
@@ -9,9 +9,9 @@ import { DYNAMIC_SECRET_PROVIDER_PICKER_ORDER } from "./registry";
describe("dynamicSecretProviderRegistry", () => {
it("composes every provider exactly once in product picker order", () => {
assert.deepEqual(dynamicSecretProviderRegistry.providers, DYNAMIC_SECRET_PROVIDER_PICKER_ORDER);
- assert.equal(dynamicSecretProviderRegistry.definitions.length, 27);
- assert.equal(new Set(dynamicSecretProviderRegistry.providers).size, 27);
- assert.equal(Object.values(DynamicSecretProviders).length, 27);
+ assert.equal(dynamicSecretProviderRegistry.definitions.length, 28);
+ assert.equal(new Set(dynamicSecretProviderRegistry.providers).size, 28);
+ assert.equal(Object.values(DynamicSecretProviders).length, 28);
});
it("preserves provider labels and documentation slugs", () => {
diff --git a/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/providerDefinitions/identityAccess.ts b/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/providerDefinitions/identityAccess.ts
index 2f29b8bedc..9e7fb9ebeb 100644
--- a/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/providerDefinitions/identityAccess.ts
+++ b/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/providerDefinitions/identityAccess.ts
@@ -8,6 +8,7 @@ import { gcpIamDynamicSecretProvider } from "./gcpIam";
import { githubDynamicSecretProvider } from "./github";
import { IDENTITY_ACCESS_DYNAMIC_SECRET_PROVIDERS } from "./identityAccessContract";
import { ldapDynamicSecretProvider } from "./ldap";
+import { oauthDynamicSecretProvider } from "./oauth";
import { sshDynamicSecretProvider } from "./ssh";
import { tailscaleDynamicSecretProvider } from "./tailscale";
@@ -17,6 +18,7 @@ const definitionsByProvider = {
[DynamicSecretProviders.AzureEntraId]: azureEntraIdDynamicSecretProvider,
[DynamicSecretProviders.Github]: githubDynamicSecretProvider,
[DynamicSecretProviders.Tailscale]: tailscaleDynamicSecretProvider,
+ [DynamicSecretProviders.OAuth]: oauthDynamicSecretProvider,
[DynamicSecretProviders.Ssh]: sshDynamicSecretProvider,
[DynamicSecretProviders.Ldap]: ldapDynamicSecretProvider
} satisfies Record<
diff --git a/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/providerDefinitions/identityAccessContract.ts b/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/providerDefinitions/identityAccessContract.ts
index 5110abba78..7a32b44626 100644
--- a/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/providerDefinitions/identityAccessContract.ts
+++ b/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/providerDefinitions/identityAccessContract.ts
@@ -7,6 +7,7 @@ export const IDENTITY_ACCESS_DYNAMIC_SECRET_PROVIDERS = [
DynamicSecretProviders.AzureEntraId,
DynamicSecretProviders.Github,
DynamicSecretProviders.Tailscale,
+ DynamicSecretProviders.OAuth,
DynamicSecretProviders.Ssh,
DynamicSecretProviders.Ldap
] as const;
diff --git a/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/providerDefinitions/index.ts b/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/providerDefinitions/index.ts
index e45636a1f4..487159a131 100644
--- a/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/providerDefinitions/index.ts
+++ b/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/providerDefinitions/index.ts
@@ -7,6 +7,7 @@ export { identityAccessDynamicSecretProviders } from "./identityAccess";
export { IDENTITY_ACCESS_DYNAMIC_SECRET_PROVIDERS } from "./identityAccessContract";
export { ldapDynamicSecretProvider } from "./ldap";
export { managedStoresDynamicSecretProviders } from "./managedStores";
+export { oauthDynamicSecretProvider } from "./oauth";
export { relationalWarehouseDynamicSecretProviders } from "./relationalWarehouse";
export { sshDynamicSecretProvider } from "./ssh";
export { sshDynamicSecretCreateBoundary, SshDynamicSecretCreateForm } from "./sshCreateForm";
diff --git a/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/providerDefinitions/oauth.tsx b/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/providerDefinitions/oauth.tsx
new file mode 100644
index 0000000000..e2692e0e29
--- /dev/null
+++ b/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/providerDefinitions/oauth.tsx
@@ -0,0 +1,197 @@
+import { Controller, useFieldArray, useFormContext } from "react-hook-form";
+import { PlusIcon, Trash2Icon } from "lucide-react";
+
+import { Button, Field, FieldError, FieldLabel, IconButton, Input } from "@app/components/v3";
+import { DynamicSecretProviders, OAuthClientAuthMethod } from "@app/hooks/api/dynamicSecret/types";
+
+import { DynamicSecretProviderFields } from "../DynamicSecretProviderFields";
+import { DynamicSecretProviderGroup } from "../DynamicSecretProviderGroup";
+import {
+ defineDynamicSecretProvider,
+ TDynamicSecretProviderCommonFields,
+ TDynamicSecretProviderField,
+ TDynamicSecretProviderRendererProps
+} from "../types";
+import {
+ getOAuthCreateDefaultValues,
+ getOAuthCreatePayload,
+ getOAuthEditDefaultValues,
+ getOAuthEditPayload,
+ OAUTH_CUSTOM_RENDERER_REASONS,
+ OAUTH_MAX_EXTRA_PARAMS,
+ oauthCreateFormSchema,
+ oauthEditFormSchema,
+ TOAuthEditFormValues
+} from "./oauthContract";
+
+const getConnectionFields = (mode: TDynamicSecretProviderRendererProps["mode"]) =>
+ [
+ {
+ name: "inputs.tokenUrl",
+ type: "text",
+ label: "Token URL",
+ placeholder: "https://auth.example.com/oauth2/token",
+ description: "The authorization server's OAuth 2.0 token endpoint."
+ },
+ {
+ name: "inputs.revocationUrl",
+ type: "text",
+ label: "Revocation URL",
+ placeholder: "https://auth.example.com/oauth2/revoke",
+ description:
+ "The RFC 7009 endpoint Infisical calls to revoke each lease's access token when the lease ends."
+ },
+ {
+ name: "inputs.clientAuth.method",
+ type: "select",
+ label: "Client Authentication",
+ description:
+ "How Infisical sends the client credentials to the token and revocation endpoints.",
+ options: [
+ {
+ label: "HTTP Basic Header",
+ value: OAuthClientAuthMethod.ClientSecretBasic
+ },
+ {
+ label: "Request Body",
+ value: OAuthClientAuthMethod.ClientSecretPost
+ }
+ ]
+ },
+ {
+ name: "inputs.clientId",
+ type: "text",
+ label: "Client ID",
+ placeholder: "Enter OAuth client ID",
+ layout: "half"
+ },
+ {
+ name: "inputs.clientAuth.clientSecret",
+ type: "secret",
+ label: "Client Secret",
+ placeholder: mode === "edit" ? "••••••••" : "Enter OAuth client secret",
+ autoComplete: "new-password",
+ layout: "half",
+ ...(mode === "edit"
+ ? { isOptional: true, description: "Leave blank to keep the current client secret." }
+ : {})
+ },
+ {
+ name: "inputs.scope",
+ type: "text",
+ label: "Scope",
+ placeholder: "read:orders write:orders",
+ isOptional: true,
+ description: "Space-separated scopes. Leave blank to use the client's default scopes."
+ }
+ ] satisfies readonly TDynamicSecretProviderField<TOAuthEditFormValues>[];
+
+const OAuthFields = ({ mode }: TDynamicSecretProviderRendererProps) => {
+ const { control } = useFormContext<TOAuthEditFormValues>();
+ const extraParams = useFieldArray({ control, name: "inputs.extraParams" });
+
+ return (
+ <>
+ <DynamicSecretProviderGroup id="oauth-configuration" presentation="panel">
+ <DynamicSecretProviderFields<TOAuthEditFormValues> fields={getConnectionFields(mode)} />
+ </DynamicSecretProviderGroup>
+
+ <DynamicSecretProviderGroup
+ id="oauth-extra-params"
+ presentation="panel"
+ surface
+ title="Extra Parameters"
+ description="Additional form parameters sent with the token request, such as audience or resource."
+ >
+ <div className="flex flex-col gap-3">
+ {extraParams.fields.map(({ id }, index) => (
+ <div
+ key={id}
+ className="grid grid-cols-1 items-start gap-3 sm:grid-cols-[minmax(0,1fr)_minmax(0,1fr)_auto]"
+ >
+ {(["key", "value"] as const).map((part) => (
+ <Controller
+ key={part}
+ control={control}
+ name={`inputs.extraParams.${index}.${part}`}
+ render={({ field, fieldState: { error } }) => {
+ const inputId = `oauth-extra-param-${index}-${part}`;
+ const errorId = `${inputId}-error`;
+
+ return (
+ <Field data-invalid={Boolean(error)}>
+ <FieldLabel htmlFor={inputId}>
+ {part === "key" ? "Name" : "Value"}
+ </FieldLabel>
+ <Input
+ {...field}
+ id={inputId}
+ placeholder={part === "key" ? "audience" : "https://api.example.com"}
+ isError={Boolean(error)}
+ aria-describedby={error ? errorId : undefined}
+ />
+ {error?.message && <FieldError id={errorId}>{error.message}</FieldError>}
+ </Field>
+ );
+ }}
+ />
+ ))}
+ <div className="flex flex-col gap-2">
+ <FieldLabel className="pointer-events-none invisible select-none" aria-hidden>
+ &nbsp;
+ </FieldLabel>
+ <IconButton
+ type="button"
+ variant="outline"
+ aria-label={`Remove parameter ${index + 1}`}
+ onClick={() => extraParams.remove(index)}
+ >
+ <Trash2Icon />
+ </IconButton>
+ </div>
+ </div>
+ ))}
+ <Button
+ type="button"
+ size="sm"
+ className="self-start"
+ isDisabled={extraParams.fields.length >= OAUTH_MAX_EXTRA_PARAMS}
+ onClick={() => extraParams.append({ key: "", value: "" })}
+ >
+ <PlusIcon />
+ Add Parameter
+ </Button>
+ </div>
+ </DynamicSecretProviderGroup>
+ </>
+ );
+};
+
+const oauthCommonFields: TDynamicSecretProviderCommonFields = {
+ ttlDescription:
+ "TTLs must fit within the token lifetime the authorization server sets. They aren't checked if the server doesn't report a lifetime."
+};
+
+export const oauthDynamicSecretProvider = defineDynamicSecretProvider({
+ provider: DynamicSecretProviders.OAuth,
+ label: "OAuth 2.0",
+ customRenderer: {
+ reasons: OAUTH_CUSTOM_RENDERER_REASONS,
+ Component: OAuthFields
+ },
+ create: {
+ schema: oauthCreateFormSchema,
+ getDefaultValues: getOAuthCreateDefaultValues,
+ toPayload: getOAuthCreatePayload,
+ commonFields: oauthCommonFields,
+ submitLabel: "Submit"
+ },
+ edit: {
+ schema: oauthEditFormSchema,
+ getDefaultValues: getOAuthEditDefaultValues,
+ toPayload: getOAuthEditPayload,
+ commonFields: oauthCommonFields,
+ submitLabel: "Submit",
+ successMessage: "Successfully updated dynamic secret"
+ }
+});
diff --git a/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/providerDefinitions/oauthContract.ts b/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/providerDefinitions/oauthContract.ts
new file mode 100644
index 0000000000..c3b029ea17
--- /dev/null
+++ b/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/providerDefinitions/oauthContract.ts
@@ -0,0 +1,240 @@
+import ms from "ms";
+import { z } from "zod";
+
+import {
+ DynamicSecretProviders,
+ OAuthClientAuthMethod,
+ OAuthGrantType,
+ TDynamicSecretProvider,
+ TUpdateDynamicSecretDTO
+} from "@app/hooks/api/dynamicSecret/types";
+
+import {
+ createDynamicSecretProviderFormSchema,
+ editDynamicSecretProviderFormSchema
+} from "../schemas";
+import {
+ TCreateDynamicSecretProviderDTO,
+ TCreateDynamicSecretProviderFormContext,
+ TDynamicSecretProviderFormValues,
+ TEditDynamicSecretProviderFormContext
+} from "../types";
+
+export const OAUTH_CUSTOM_RENDERER_REASONS = ["repeatable-fields"] as const;
+export const OAUTH_MAX_EXTRA_PARAMS = 20;
+
+// keep in sync with OAUTH_RESERVED_PARAMS in backend/src/ee/services/dynamic-secret/providers/models.ts
+const OAUTH_RESERVED_PARAMS = new Set([
+ "grant_type",
+ "scope",
+ "client_id",
+ "client_secret",
+ "client_assertion",
+ "client_assertion_type"
+]);
+const SCOPE_TOKEN_REGEX = /^[\x21\x23-\x5B\x5D-\x7E]+$/;
+const PARAM_KEY_REGEX = /^[A-Za-z0-9._~:[\]-]+$/;
+
+type TOAuthInputs = Extract<
+ TDynamicSecretProvider,
+ { type: DynamicSecretProviders.OAuth }
+>["inputs"];
+
+export const normalizeOAuthScope = (scope?: string) =>
+ [...new Set((scope ?? "").split(/\s+/).filter(Boolean))].join(" ");
+
+const urlSchema = (label: string) =>
+ z.string().trim().min(1, `${label} is required`).max(2048).url(`${label} must be a valid URL`);
+
+const scopeSchema = z
+ .string()
+ .trim()
+ .max(2048)
+ .optional()
+ .superRefine((scope, context) => {
+ const invalidTokens = (scope ?? "")
+ .split(/\s+/)
+ .filter((token) => token && !SCOPE_TOKEN_REGEX.test(token));
+ if (invalidTokens.length) {
+ context.addIssue({
+ code: z.ZodIssueCode.custom,
+ message: `Scope contains invalid characters: ${invalidTokens.join(", ")}`
+ });
+ }
+ });
+
+const extraParamsSchema = z
+ .array(
+ z.object({
+ key: z
+ .string()
+ .trim()
+ .min(1, "Parameter name is required")
+ .max(128)
+ .regex(PARAM_KEY_REGEX, "Parameter name contains invalid characters")
+ .refine(
+ (key) => !OAUTH_RESERVED_PARAMS.has(key.toLowerCase()),
+ "Infisical sets this parameter"
+ ),
+ value: z.string().trim().min(1, "Parameter value is required").max(2048)
+ })
+ )
+ .max(OAUTH_MAX_EXTRA_PARAMS, `At most ${OAUTH_MAX_EXTRA_PARAMS} extra parameters are allowed`)
+ .superRefine((params, context) => {
+ const seen = new Set<string>();
+ params.forEach(({ key }, index) => {
+ if (seen.has(key.trim())) {
+ context.addIssue({
+ code: z.ZodIssueCode.custom,
+ path: [index, "key"],
+ message: "Parameter is set more than once"
+ });
+ }
+ seen.add(key.trim());
+ });
+ });
+
+const oauthBaseInputs = {
+ grantType: z.literal(OAuthGrantType.ClientCredentials),
+ tokenUrl: urlSchema("Token URL"),
+ revocationUrl: urlSchema("Revocation URL"),
+ clientId: z.string().trim().min(1, "Client ID is required").max(1024),
+ scope: scopeSchema,
+ extraParams: extraParamsSchema
+};
+
+const makeClientAuthSchema = <T extends z.ZodTypeAny>(clientSecret: T) =>
+ z.discriminatedUnion("method", [
+ z.object({ method: z.literal(OAuthClientAuthMethod.ClientSecretBasic), clientSecret }),
+ z.object({ method: z.literal(OAuthClientAuthMethod.ClientSecretPost), clientSecret })
+ ]);
+
+const oauthCreateInputsSchema = z.object({
+ ...oauthBaseInputs,
+ clientAuth: makeClientAuthSchema(z.string().trim().min(1, "Client secret is required").max(4096))
+});
+
+// the stored secret is never returned, so an empty value on edit keeps it
+const oauthEditInputsSchema = z.object({
+ ...oauthBaseInputs,
+ clientAuth: makeClientAuthSchema(z.string().trim().max(4096).optional())
+});
+
+export type TOAuthCreateFormValues = TDynamicSecretProviderFormValues<
+ z.infer<typeof oauthCreateInputsSchema>
+>;
+export type TOAuthEditFormValues = TDynamicSecretProviderFormValues<
+ z.infer<typeof oauthEditInputsSchema>
+>;
+
+const withTtlOrder = <T extends z.ZodTypeAny>(schema: T) =>
+ schema.refine(
+ (data: { defaultTTL?: string; maxTTL?: string | null }) => {
+ if (!data.maxTTL || !data.defaultTTL) return true;
+ const maxTtlMs = ms(data.maxTTL);
+ const defaultTtlMs = ms(data.defaultTTL);
+ if (maxTtlMs === undefined || defaultTtlMs === undefined) return true;
+ return maxTtlMs >= defaultTtlMs;
+ },
+ { path: ["maxTTL"], message: "Max TTL must be greater than or equal to Default TTL" }
+ );
+
+export const oauthCreateFormSchema = withTtlOrder(
+ createDynamicSecretProviderFormSchema(oauthCreateInputsSchema)
+) as z.ZodType<TOAuthCreateFormValues>;
+
+export const oauthEditFormSchema = withTtlOrder(
+ editDynamicSecretProviderFormSchema(oauthEditInputsSchema)
+) as z.ZodType<TOAuthEditFormValues>;
+
+export const getOAuthCreateDefaultValues = (
+ context: TCreateDynamicSecretProviderFormContext
+): TOAuthCreateFormValues => ({
+ name: "",
+ defaultTTL: "30m",
+ maxTTL: "1h",
+ environment: context.isSingleEnvironmentMode ? context.environments[0] : undefined,
+ inputs: {
+ grantType: OAuthGrantType.ClientCredentials,
+ tokenUrl: "",
+ revocationUrl: "",
+ clientId: "",
+ clientAuth: { method: OAuthClientAuthMethod.ClientSecretBasic, clientSecret: "" },
+ scope: "",
+ extraParams: []
+ }
+});
+
+export const getOAuthEditDefaultValues = (
+ context: TEditDynamicSecretProviderFormContext
+): TOAuthEditFormValues => {
+ const inputs = context.dynamicSecret.inputs as Partial<TOAuthInputs>;
+ return {
+ name: context.dynamicSecret.name,
+ defaultTTL: context.dynamicSecret.defaultTTL,
+ maxTTL: context.dynamicSecret.maxTTL,
+ inputs: {
+ grantType: OAuthGrantType.ClientCredentials,
+ tokenUrl: inputs.tokenUrl ?? "",
+ revocationUrl: inputs.revocationUrl ?? "",
+ clientId: inputs.clientId ?? "",
+ clientAuth: {
+ method: inputs.clientAuth?.method ?? OAuthClientAuthMethod.ClientSecretBasic,
+ clientSecret: ""
+ },
+ scope: inputs.scope ?? "",
+ extraParams: inputs.extraParams ?? []
+ }
+ };
+};
+
+const buildInputs = (inputs: TOAuthEditFormValues["inputs"]) => {
+ const clientSecret = inputs.clientAuth.clientSecret?.trim();
+ return {
+ grantType: OAuthGrantType.ClientCredentials,
+ tokenUrl: inputs.tokenUrl.trim(),
+ revocationUrl: inputs.revocationUrl.trim(),
+ clientId: inputs.clientId.trim(),
+ clientAuth: { method: inputs.clientAuth.method, ...(clientSecret ? { clientSecret } : {}) },
+ extraParams: inputs.extraParams.map(({ key, value }) => ({
+ key: key.trim(),
+ value: value.trim()
+ }))
+ } as const;
+};
+
+export const getOAuthCreatePayload = (
+ values: TOAuthCreateFormValues,
+ context: TCreateDynamicSecretProviderFormContext
+): TCreateDynamicSecretProviderDTO<DynamicSecretProviders.OAuth> => ({
+ provider: {
+ type: DynamicSecretProviders.OAuth,
+ inputs: {
+ ...buildInputs(values.inputs),
+ scope: normalizeOAuthScope(values.inputs.scope) || undefined
+ }
+ },
+ defaultTTL: values.defaultTTL,
+ maxTTL: values.maxTTL ?? undefined,
+ name: values.name,
+ path: context.secretPath,
+ projectSlug: context.projectSlug,
+ environmentSlug: values.environment?.slug ?? ""
+});
+
+export const getOAuthEditPayload = (
+ values: TOAuthEditFormValues,
+ context: TEditDynamicSecretProviderFormContext
+): TUpdateDynamicSecretDTO => ({
+ name: context.dynamicSecret.name,
+ path: context.secretPath,
+ projectSlug: context.projectSlug,
+ environmentSlug: context.environment,
+ data: {
+ // an omitted scope would keep the stored one, so a cleared scope is sent as ""
+ inputs: { ...buildInputs(values.inputs), scope: normalizeOAuthScope(values.inputs.scope) },
+ newName: values.name === context.dynamicSecret.name ? undefined : values.name,
+ defaultTTL: values.defaultTTL,
+ maxTTL: values.maxTTL
+ }
+});
diff --git a/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/registry.ts b/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/registry.ts
index 4883b6153c..cc50a3f0e8 100644
--- a/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/registry.ts
+++ b/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/registry.ts
@@ -53,7 +53,8 @@ export const DYNAMIC_SECRET_PROVIDER_PICKER_ORDER = [
DynamicSecretProviders.Clickhouse,
DynamicSecretProviders.Ssh,
DynamicSecretProviders.IbmApiConnect,
- DynamicSecretProviders.Tailscale
+ DynamicSecretProviders.Tailscale,
+ DynamicSecretProviders.OAuth
] as const satisfies readonly DynamicSecretProviders[];
const DYNAMIC_SECRET_PROVIDER_DOCS_SLUG: Partial<Record<DynamicSecretProviders, string>> = {
diff --git a/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/runtimeMetadata.test.ts b/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/runtimeMetadata.test.ts
index 8a4176293f..7baf91d127 100644
--- a/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/runtimeMetadata.test.ts
+++ b/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/runtimeMetadata.test.ts
@@ -49,7 +49,8 @@ describe("dynamic-secret provider runtime metadata", () => {
[
DynamicSecretProviders.Github,
DynamicSecretProviders.Ssh,
- DynamicSecretProviders.Tailscale
+ DynamicSecretProviders.Tailscale,
+ DynamicSecretProviders.OAuth
].forEach((provider) => {
assert.equal(
getDynamicSecretProviderRuntimeMetadata(provider).leaseCapabilities.supportsRenewal,
diff --git a/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/runtimeMetadata.ts b/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/runtimeMetadata.ts
index 7abb235708..18ea417e90 100644
--- a/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/runtimeMetadata.ts
+++ b/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/runtimeMetadata.ts
@@ -27,6 +27,7 @@ export type TDynamicSecretLeaseCapabilities = {
supportsRenewal: boolean;
autoGenerate?: boolean;
fixedTtl?: string;
+ ttlDescription?: string;
};
export type TDynamicSecretProviderRuntimeMetadata = {
@@ -245,6 +246,21 @@ const DYNAMIC_SECRET_PROVIDER_RUNTIME_METADATA = {
]),
supportsRenewal: false
}
+ },
+ [DynamicSecretProviders.OAuth]: {
+ presentation: { providerFamily: "OAuth" },
+ leaseCapabilities: {
+ provisioner: "default",
+ output: oneTimeFields([
+ { key: "ACCESS_TOKEN", label: "Access Token" },
+ { key: "TOKEN_TYPE", label: "Token Type", isOptional: true },
+ { key: "EXPIRES_AT", label: "Expires At", isOptional: true },
+ { key: "SCOPE", label: "Scope", isOptional: true }
+ ]),
+ supportsRenewal: false,
+ ttlDescription:
+ "Must fit within the token lifetime the authorization server sets. Not checked if the server doesn't report a lifetime."
+ }
}
} as const satisfies Record<DynamicSecretProviders, TDynamicSecretProviderRuntimeMetadata>;
diff --git a/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/types.ts b/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/types.ts
index 711fea0b24..db1d00fb62 100644
--- a/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/types.ts
+++ b/frontend/src/components/dynamic-secrets/DynamicSecretProviderForm/types.ts
@@ -39,6 +39,8 @@ export type TDynamicSecretProviderCommonFields = {
name?: TDynamicSecretProviderCommonField;
defaultTTL?: TDynamicSecretProviderCommonField;
maxTTL?: TDynamicSecretProviderCommonField;
+ // applies to both TTL fields, so it renders once below the row instead of under each input
+ ttlDescription?: string;
environment?: TDynamicSecretProviderCommonField;
configurationHeading?: string | false;
};
diff --git a/frontend/src/hooks/api/dynamicSecret/types.ts b/frontend/src/hooks/api/dynamicSecret/types.ts
index cab9ba1679..2425aa5df1 100644
--- a/frontend/src/hooks/api/dynamicSecret/types.ts
+++ b/frontend/src/hooks/api/dynamicSecret/types.ts
@@ -45,7 +45,17 @@ export enum DynamicSecretProviders {
Milvus = "milvus",
Ssh = "ssh",
IbmApiConnect = "ibm-api-connect",
- Tailscale = "tailscale"
+ Tailscale = "tailscale",
+ OAuth = "oauth"
+}
+
+export enum OAuthGrantType {
+ ClientCredentials = "client-credentials"
+}
+
+export enum OAuthClientAuthMethod {
+ ClientSecretBasic = "client_secret_basic",
+ ClientSecretPost = "client_secret_post"
}
export enum TailscaleKeyAuthType {
@@ -576,6 +586,21 @@ export type TDynamicSecretProvider =
subject: string;
audience?: string;
};
+ }
+ | {
+ type: DynamicSecretProviders.OAuth;
+ inputs: {
+ grantType: OAuthGrantType.ClientCredentials;
+ tokenUrl: string;
+ revocationUrl: string;
+ clientId: string;
+ clientAuth: {
+ method: OAuthClientAuthMethod;
+ clientSecret?: string;
+ };
+ scope?: string;
+ extraParams: { key: string; value: string }[];
+ };
};
export type TCreateDynamicSecretDTO = {
diff --git a/frontend/src/pages/secret-manager/SecretDashboardPage/components/DynamicSecretListView/CreateDynamicSecretLease.tsx b/frontend/src/pages/secret-manager/SecretDashboardPage/components/DynamicSecretListView/CreateDynamicSecretLease.tsx
index 21bd537358..b4c8344822 100644
--- a/frontend/src/pages/secret-manager/SecretDashboardPage/components/DynamicSecretListView/CreateDynamicSecretLease.tsx
+++ b/frontend/src/pages/secret-manager/SecretDashboardPage/components/DynamicSecretListView/CreateDynamicSecretLease.tsx
@@ -738,7 +738,8 @@ export const CreateDynamicSecretLease = ({
return <Spinner className="mx-auto my-12" label="Provisioning lease" />;
}
- const { fixedTtl } = leaseCapabilities;
+ const { fixedTtl, ttlDescription } = leaseCapabilities;
+ const ttlFeedback = fixedTtl ? `This provider has a fixed TTL of ${fixedTtl}.` : ttlDescription;
if (isOutputMode) {
return renderOutputForm(
@@ -763,13 +764,13 @@ export const CreateDynamicSecretLease = ({
disabled={Boolean(fixedTtl)}
isError={Boolean(error)}
aria-describedby={
- fixedTtl || error?.message ? "dynamic-secret-lease-ttl-feedback" : undefined
+ ttlFeedback || error?.message ? "dynamic-secret-lease-ttl-feedback" : undefined
}
/>
- {(fixedTtl || error?.message) && (
+ {(ttlFeedback || error?.message) && (
<FieldFeedback
id="dynamic-secret-lease-ttl-feedback"
- description={fixedTtl ? `This provider has a fixed TTL of ${fixedTtl}.` : undefined}
+ description={ttlFeedback}
error={error?.message}
/>
)}