2025-11-13 13:13:34 -07:00

135 lines
4.6 KiB
TypeScript

import { APIResource } from "../../resource.js";
import * as Core from "../../core.js";
import * as UserSchemasAPI from "./user-schemas/user-schemas.js";
export declare class Configurations extends APIResource {
/**
* Set configuration properties
*
* @example
* ```ts
* const configuration =
* await client.apiGateway.configurations.update({
* zone_id: '023e105f4ecef8ad9ca31a8372d0c353',
* auth_id_characteristics: [
* { name: 'authorization', type: 'header' },
* ],
* });
* ```
*/
update(params: ConfigurationUpdateParams, options?: Core.RequestOptions): Core.APIPromise<ConfigurationUpdateResponse>;
/**
* Retrieve information about specific configuration properties
*
* @example
* ```ts
* const configuration =
* await client.apiGateway.configurations.get({
* zone_id: '023e105f4ecef8ad9ca31a8372d0c353',
* });
* ```
*/
get(params: ConfigurationGetParams, options?: Core.RequestOptions): Core.APIPromise<Configuration>;
}
export interface Configuration {
auth_id_characteristics: Array<Configuration.APIShieldAuthIDCharacteristic | Configuration.APIShieldAuthIDCharacteristicJWTClaim>;
}
export declare namespace Configuration {
/**
* Auth ID Characteristic
*/
interface APIShieldAuthIDCharacteristic {
/**
* The name of the characteristic field, i.e., the header or cookie name.
*/
name: string;
/**
* The type of characteristic.
*/
type: 'header' | 'cookie';
}
/**
* Auth ID Characteristic extracted from JWT Token Claims
*/
interface APIShieldAuthIDCharacteristicJWTClaim {
/**
* Claim location expressed as `$(token_config_id):$(json_path)`, where
* `token_config_id` is the ID of the token configuration used in validating the
* JWT, and `json_path` is a RFC 9535 JSONPath
* (https://goessner.net/articles/JsonPath/,
* https://www.rfc-editor.org/rfc/rfc9535.html). The JSONPath expression may be in
* dot or bracket notation, may only specify literal keys or array indexes, and
* must return a singleton value, which will be interpreted as a string.
*/
name: string;
/**
* The type of characteristic.
*/
type: 'jwt';
}
}
export interface ConfigurationUpdateResponse {
errors: UserSchemasAPI.Message;
messages: UserSchemasAPI.Message;
/**
* Whether the API call was successful.
*/
success: true;
}
export interface ConfigurationUpdateParams {
/**
* Path param: Identifier.
*/
zone_id: string;
/**
* Body param:
*/
auth_id_characteristics: Array<ConfigurationUpdateParams.APIShieldAuthIDCharacteristic | ConfigurationUpdateParams.APIShieldAuthIDCharacteristicJWTClaim>;
}
export declare namespace ConfigurationUpdateParams {
/**
* Auth ID Characteristic
*/
interface APIShieldAuthIDCharacteristic {
/**
* The name of the characteristic field, i.e., the header or cookie name.
*/
name: string;
/**
* The type of characteristic.
*/
type: 'header' | 'cookie';
}
/**
* Auth ID Characteristic extracted from JWT Token Claims
*/
interface APIShieldAuthIDCharacteristicJWTClaim {
/**
* Claim location expressed as `$(token_config_id):$(json_path)`, where
* `token_config_id` is the ID of the token configuration used in validating the
* JWT, and `json_path` is a RFC 9535 JSONPath
* (https://goessner.net/articles/JsonPath/,
* https://www.rfc-editor.org/rfc/rfc9535.html). The JSONPath expression may be in
* dot or bracket notation, may only specify literal keys or array indexes, and
* must return a singleton value, which will be interpreted as a string.
*/
name: string;
/**
* The type of characteristic.
*/
type: 'jwt';
}
}
export interface ConfigurationGetParams {
/**
* Path param: Identifier.
*/
zone_id: string;
/**
* Query param: Requests information about certain properties.
*/
properties?: Array<'auth_id_characteristics'>;
}
export declare namespace Configurations {
export { type Configuration as Configuration, type ConfigurationUpdateResponse as ConfigurationUpdateResponse, type ConfigurationUpdateParams as ConfigurationUpdateParams, type ConfigurationGetParams as ConfigurationGetParams, };
}
//# sourceMappingURL=configurations.d.ts.map