openapi: 3.0.0
info:
title: Secret Server Rest Activations SecretDependencies API
description: REST API documentation for Secret Server. This document describes how to use the REST API. All requests require an authentication token; please see the authentication document for more information. The Swagger specification for this API is also available.
termsOfService: https://delinea.com/eula
contact:
name: Support
url: https://delinea.com
version: 11.7.2
servers:
- url: /SecretServer/api
security:
- BearerToken: []
tags:
- name: SecretDependencies
description: View and maintain Secret Dependencies
paths:
/v1/secret-dependencies/{id}:
put:
tags:
- SecretDependencies
summary: Update Secret Dependency
description: Updates a Secret Dependency and returns the model
operationId: SecretDependenciesService_UpdateDependency
parameters:
- name: id
in: path
description: Secret Dependency ID
required: true
schema:
type: integer
format: int32
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SecretDependencyUpdateArgs'
description: Secret Dependency update options
responses:
'200':
description: SecretDependencyModel object
content:
application/json:
schema:
$ref: '#/components/schemas/SecretDependencyUpdateArgs'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
delete:
tags:
- SecretDependencies
summary: Delete Secret Dependency
description: Delete a Secret Dependency by ID
operationId: SecretDependenciesService_Delete
parameters:
- name: id
in: path
description: Secret Dependency ID
required: true
schema:
type: integer
format: int32
responses:
'200':
description: Object deletion result
content:
application/json:
schema:
$ref: '#/components/schemas/DeletedModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/secret-dependencies/groups/{secretId}:
get:
tags:
- SecretDependencies
summary: Get Secret Dependency Groups for a Secret
description: Get Secret Dependency Groups for a Secret
operationId: SecretDependenciesService_GetGroups
parameters:
- name: secretId
in: path
description: Secret ID
required: true
schema:
type: integer
format: int32
responses:
'200':
description: Secret Dependency Group array
content:
application/json:
schema:
$ref: '#/components/schemas/ILogicResultOfSecretDependencyGroupArray'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
put:
tags:
- SecretDependencies
summary: Update Secret Dependency Group
description: Update a Secret Dependency Group
operationId: SecretDependenciesService_UpdateSecretDependencyGroup
parameters:
- name: secretId
in: path
description: Id of Secret to assign to Dependency Group.
required: true
schema:
type: integer
format: int32
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateSecretDependencyGroupArgs'
description: args
responses:
'200':
description: SecretDependencyGroupModel object
content:
application/json:
schema:
$ref: '#/components/schemas/SecretDependencyGroupModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
post:
tags:
- SecretDependencies
summary: Create Secret Dependency Group
description: Creates a new Secret Dependency Group and returns the model
operationId: SecretDependenciesService_CreateDependencyGroup
parameters:
- name: secretId
in: path
description: Secret ID
required: true
schema:
type: integer
format: int32
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SecretDependencyGroupCreateArgs'
description: Secret Dependency create options
responses:
'200':
description: Secret Dependency Group object
content:
application/json:
schema:
$ref: '#/components/schemas/SecretDependencyGroup'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/secret-dependencies/scripts:
get:
tags:
- SecretDependencies
summary: Get Scripts that are possible to use for Dependencies
description: Get Scripts that are possible to use for Dependencies
operationId: SecretDependenciesService_GetScripts
responses:
'200':
description: Dependency Script array
content:
application/json:
schema:
$ref: '#/components/schemas/ILogicResultOfDependencyScriptArray'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/secret-dependencies/templates:
get:
tags:
- SecretDependencies
summary: Get Dependency Templates
description: Get Dependency Templates
operationId: SecretDependenciesService_GetTemplates
responses:
'200':
description: Dependency Template array
content:
application/json:
schema:
$ref: '#/components/schemas/ILogicResultOfDependencyTemplateArray'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/secret-dependencies/{secretDependencyId}:
get:
tags:
- SecretDependencies
summary: Get Secret Dependency
description: Gets a Secret Dependency and returns the Secret Dependency Model
operationId: SecretDependenciesService_GetDependency
parameters:
- name: secretDependencyId
in: path
description: Secret Dependency ID
required: true
schema:
type: integer
format: int32
responses:
'200':
description: Secret Dependency object
content:
application/json:
schema:
$ref: '#/components/schemas/SecretDependencyModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/secret-dependencies:
get:
tags:
- SecretDependencies
summary: Search Secret Dependencies
description: Search, filter, sort, and page Secret Dependencies on a Secret
operationId: SecretDependenciesService_SearchDependencySummary
parameters:
- name: filter.groupId
in: query
description: Filter by group id
required: false
x-nullable: true
schema:
type: integer
format: int32
- name: filter.includeInactive
in: query
description: Whether or not to include inactive Secret Depenencies
required: false
schema:
type: boolean
- name: filter.lastRunStatus
in: query
description: Filter by last dependency result status
required: false
x-nullable: true
schema:
type: string
- name: filter.searchText
in: query
description: Search in the title / name and machine fields
required: false
schema:
type: string
- name: filter.secretId
in: query
description: The Secret Id to filter on
required: true
schema:
type: integer
format: int32
- name: filter.templateId
in: query
description: Filter by dependency template id
required: false
x-nullable: true
schema:
type: integer
format: int32
- name: skip
in: query
description: Number of records to skip before taking results
required: false
schema:
type: integer
format: int32
- name: sortBy[0].direction
in: query
description: Sort direction
required: false
schema:
type: string
- name: sortBy[0].name
in: query
description: Sort field name
required: false
schema:
type: string
- name: sortBy[0].priority
in: query
description: Priority index. Sorts with lower values are executed earlier
required: false
schema:
type: integer
format: int32
- name: take
in: query
description: Maximum number of records to include in results
required: false
schema:
type: integer
format: int32
responses:
'200':
description: SecretDependency search result object
content:
application/json:
schema:
$ref: '#/components/schemas/PagingOfSecretDependencySummary'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
post:
tags:
- SecretDependencies
summary: Create Secret Dependency
description: Creates a new Secret Dependency and returns the model
operationId: SecretDependenciesService_CreateDependency
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SecretDependencyCreateArgs'
description: Secret Dependency create options
responses:
'200':
description: Secret Dependency object
content:
application/json:
schema:
$ref: '#/components/schemas/SecretDependencyModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/secret-dependencies/run/{identifier}:
get:
tags:
- SecretDependencies
summary: Get Secret Dependency run task status
description: Gets a Secret Dependency run task status
operationId: SecretDependenciesService_GetDependencyRunTaskStatus
parameters:
- name: identifier
in: path
description: Task identifier
required: true
schema:
type: string
responses:
'200':
description: Task Status
content:
application/json:
schema:
$ref: '#/components/schemas/TaskProgress'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/secret-dependencies/stub:
get:
tags:
- SecretDependencies
summary: Get Secret Dependency Stub
description: Return the default values for a new Secret Dependency
operationId: SecretDependenciesService_Stub
parameters:
- name: scriptId
in: query
description: The Id of the Script that this Dependency will Run. Only provide this value if the Dependency is running a script directly, and ensure that the type of the script matches the TypeId value passed in.
required: false
x-nullable: true
schema:
type: integer
format: int32
- name: secretId
in: query
description: The Id of the Secret that this Dependency will appear on
required: false
schema:
type: integer
format: int32
- name: templateId
in: query
description: The Id of the Dependency Template that this Dependecy will be modeled on. Only provide this value if the Dependency is based on a Template.
required: false
x-nullable: true
schema:
type: integer
format: int32
- name: typeId
in: query
description: 'The Id of the Dependency Type that this Dependecy will be modeled on. Only provide this value if the Dependency is a running a script directly and is NOT based on a Dependency Template. Valid Values: PowershellScript = 7, SshScript = 8, SqlScript = 9'
required: false
x-nullable: true
schema:
type: integer
format: int32
responses:
'200':
description: SecretDependencyModel
content:
application/json:
schema:
$ref: '#/components/schemas/SecretDependencyModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/secret-dependencies/run:
post:
tags:
- SecretDependencies
summary: Run Dependencies
description: Runs the list of dependencies and retruns an identifier that can be used to collect the status.
operationId: SecretDependenciesService_Execute
requestBody:
content:
application/json:
schema:
description: Int32[]
items:
type: integer
format: int32
type: array
description: Dependency Id array
responses:
'200':
description: Identifier of the task
content:
application/json:
schema:
description: String
type: string
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
components:
schemas:
Sort:
description: Sort options. Multiple sort options can be provided in the query string.
required:
- name
- direction
properties:
direction:
$ref: '#/components/schemas/SortDirection'
name:
description: Sort field name
type: string
priority:
description: Priority index. Sorts with lower values are executed earlier
type: integer
format: int32
type: object
SecretDependencyOdbcConnectionArg:
description: Connection arguments used for ODBC connections
properties:
name:
description: Name of the argument
type: string
value:
description: Value for the argument
type: string
type: object
SecretDependencySetting:
description: Secret Dependency Settings - Mostly used internally
properties:
active:
description: Indicates the setting is active.
type: boolean
canEdit:
description: Indicates the setting details may be editted.
type: boolean
canEditValue:
description: Indicates the setting value may be editted.
type: boolean
childSettings:
description: The Child Settings that would be used for list of options.
items:
$ref: '#/components/schemas/SecretDependencySetting'
type: array
defaultValue:
description: Default value if the setting is not given a value
type: string
displayName:
description: Setting Display Name
type: string
id:
description: Id of the setting
type: integer
format: int32
isVisibile:
description: Indicates the setting is visible on the UI.
type: boolean
parentSettingId:
description: Parent Setting Id used when a setting has child options.
type: integer
format: int32
nullable: true
regexValidation:
description: Regex used to validate the input
type: string
settingName:
description: Name of the setting
type: string
settingSectionId:
description: Section Id of the setting
type: integer
format: int32
settingType:
description: Type of Setting (Default (string) = 0, Integer = 1, String = 2, Boolean = 3, StringArray = 4, DropDown = 5,DropDownItem = 6
type: integer
format: int32
subSettingSectionId:
description: Subsetting Section Id
type: integer
format: int32
nullable: true
type: object
SecretDependencyTemplate:
description: Object filled and used for Secret Dependencies that refer to a Dependency Template
properties:
changerScriptId:
description: The id of the script (if any) used by the Dependency Template
type: integer
format: int32
nullable: true
dependencyScanItemFields:
description: The Scan Item Fields used by the Dependency Template
items:
$ref: '#/components/schemas/SecretDependencyScanItemField'
type: array
scriptName:
description: The name of the script (if any) used by the Dependency Template
type: string
secretDependencyChangerId:
description: The id of the Dependency Changer used by the Dependency Template
type: integer
format: int32
nullable: true
secretDependencyTemplateId:
description: The id of the Dependency Template
type: integer
format: int32
nullable: true
type: object
SortDirection:
description: Sort direction
properties: {}
type: string
enum:
- None
- Asc
- Desc
Severity:
description: Error severity level
properties: {}
type: string
enum:
- None
- Retry
- Warn
- Critical
- Fatal
DependencyRunResultStatus:
description: The last run result for this dependency
properties: {}
type: string
enum:
- Success
- Failed
- NotRun
InternalServerErrorResponse:
description: Response object for internal server errors
required:
- message
- exceptionMessage
- exceptionType
- stackTrace
properties:
message:
description: Error message
type: string
exceptionMessage:
description: Error message from exception
type: string
exceptionType:
description: Exception type
type: string
stackTrace:
description: Exception stack trace
type: string
type: object
SecretDependencySummary:
description: The Summary object for a Secret Dependency
properties:
canTest:
description: Whether or not this dependency can be tested
type: boolean
enabled:
description: Whether or not this dependency is enabled
type: boolean
groupId:
description: The Id of the Dependency Group that contains the Secret Dependency
type: integer
format: int32
groupName:
description: The name of the Dependency Group that contains the Secret Dependency
type: string
id:
description: The Id of the Secret Dependency
type: integer
format: int32
machineName:
description: The machine name that the Secret Dependency runs on
type: string
order:
description: The order for this dependency within its group
type: integer
format: int32
runResult:
$ref: '#/components/schemas/DependencyRunResultStatus'
secretId:
description: The Id of the Secret that the Secret Dependency is assigned to
type: integer
format: int32
serviceName:
description: The service name of the Secret Dependency
type: string
typeId:
description: The Id of the type of Secret Dependency
type: integer
format: int32
typeName:
description: The name of the type of Secret Dependency
type: string
type: object
ILogicResultOfDependencyScriptArray:
description: ILogicResultOfDependencyScript[]
properties:
model:
description: Model
items:
$ref: '#/components/schemas/DependencyScript'
type: array
type: object
SecretDependencySettingMapForDisplay:
description: Settings used by Secret Dependency Templates
properties:
changerSettingValue:
description: The default read-only setting value on the changer that will be used if no setting value has been given.
type: string
setting:
$ref: '#/components/schemas/SecretDependencySetting'
settingId:
description: The Setting Id
type: integer
format: int32
settingName:
description: The Setting Name
type: string
settingValue:
description: The value for the setting that will be stored in the database. This value should be set when editing or creating a Dependency. If not set the default value will be calculated by looking at the Changer or Script.
type: string
type: object
BadRequestResponse:
description: Response object for invalid requests
required:
- message
properties:
message:
description: Error message
type: string
messageDetail:
description: Error message detail
type: string
errorCode:
description: Error message code
type: string
modelState:
description: An object describing validation errors
type: object
type: object
SecretDependencyCreateArgs:
description: The Secret Dependency Create Arguments object
properties:
active:
description: Whether or not the Secret Dependency is active.
type: boolean
conditionDependencyId:
description: The Id of the dependency that will be looked at when Condition Mode is set to 'DEPENDENCYPASS', 'DEPENDENCYFAIL'. The Dependency must have a SortOrder lower than the current one.
type: integer
format: int32
nullable: true
conditionMode:
description: Condition Mode governs if this dependency's run relies on the result of other dependencies above it. The Default is ALWAYSRUN. Other values maybe 'All Pass', 'Any Fail', 'DEPENDENCYPASS', 'DEPENDENCYFAIL'.
type: string
dependencyTemplate:
$ref: '#/components/schemas/SecretDependencyTemplate'
description:
description: A description for the Secret Dependency.
type: string
groupId:
description: The Id of the Dependency Group that contains the Secret Dependency. If set to default value of 0, it will be added to the first group on the secret.
type: integer
format: int32
machineName:
description: The machine name that the Secret Dependency runs on.
type: string
privilegedAccountSecretId:
description: The Id of the Privileged Secret that the Secret Dependency will use to run.
type: integer
format: int32
nullable: true
runScript:
$ref: '#/components/schemas/SecretDependencyRunScript'
secretId:
description: The Id of the Secret that the Secret Dependency is assigned to.
type: integer
format: int32
secretName:
description: Read Only. The Name of the Secret that the Secret Dependency is assigned to.
type: string
serviceName:
description: The service name of the Secret Dependency.
type: string
settings:
description: 'The Settings used by the Secret Dependency. (Ex: WaitBeforeSeconds, Database, Port, SSHKeyDigest)'
items:
$ref: '#/components/schemas/SecretDependencySettingMapForDisplay'
type: array
sortOrder:
description: The sort order of the Secret Dependency in the group. Determines the order of execution of the dependencies within a group. If set to the default value of 0, the dependency will be added at the end of the group. If less than zero the dependency will be added as the first dependency in the group and all other dependencies in the group will be adjusted.
type: integer
format: int32
sshKeySecretId:
description: The Id of the Secret containing the SSH key. (If dependency is tied to SSH key Secret)
type: integer
format: int32
nullable: true
typeId:
description: The Id of the type of Secret Dependency.
type: integer
format: int32
typeName:
description: Read Only. The name of the type of Secret Dependency.
type: string
type: object
SecretDependencyModel:
description: The Secret Dependency model object
properties:
active:
description: Whether or not the Secret Dependency is active.
type: boolean
childDependencyStatus:
description: The last run status of the child Secret Dependency.
type: boolean
nullable: true
conditionDependencyId:
description: The Id of the dependency that will be looked at when Condition Mode is set to 'DEPENDENCYPASS', 'DEPENDENCYFAIL'. The Dependency must have a SortOrder lower than the current one.
type: integer
format: int32
nullable: true
conditionMode:
description: Condition Mode governs if this dependency's run relies on the result of other dependencies above it. The Default is ALWAYSRUN. Other values maybe 'All Pass', 'Any Fail', 'DEPENDENCYPASS', 'DEPENDENCYFAIL'.
type: string
dependencyTemplate:
$ref: '#/components/schemas/SecretDependencyTemplate'
description:
description: A description for the Secret Dependency.
type: string
groupId:
description: The Id of the Dependency Group that contains the Secret Dependency.
type: integer
format: int32
id:
description: The Id of the Secret Dependency.
type: integer
format: int32
logMessage:
description: The last Log message for the Secret Dependency.
type: string
privilegedAccountSecretId:
description: The Id of the Privileged Secret that the Secret Dependency will use to run.
type: integer
format: int32
nullable: true
runScript:
$ref: '#/components/schemas/SecretDependencyRunScript'
secretDependencyStatus:
description: The last run status of the Secret Dependency.
type: boolean
nullable: true
secretId:
description: The Id of the Secret that the Secret Dependency is assigned to.
type: integer
format: int32
secretName:
description: The Name of the Secret that the Secret Dependency is assigned to.
type: string
settings:
description: 'The Settings used by the Secret Dependency. (Ex: WaitBeforeSeconds, Database, Port, SSHKeyDigest). If a setting exists with the same name (or intent in the case of Port and SqlPort) as a field on the Dependency template''s DependencyScanItemFields collection, the value assigned to the setting takes precedence and will overwrite the corresponding DependencyScanItemField.'
items:
$ref: '#/components/schemas/SecretDependencySettingMapForDisplay'
type: array
sortOrder:
description: The sort order of the Secret Dependency in the group. Determines the order of execution of the dependencies within a group.
type: integer
format: int32
sshKeySecretId:
description: The Id of the Secret containing the SSH key. (If dependency is tied to SSH key Secret
type: integer
format: int32
nullable: true
sshKeySecretName:
description: The Name of the Secret containing the SSH key. (If dependency is tied to SSH key Secret
type: string
typeId:
description: The Id of the type of Secret Dependency.
type: integer
format: int32
typeName:
description: The name of the type of Secret Dependency.
type: string
type: object
UpdateSecretDependencyGroupModel:
description: Update Secret Dependency Group Options
properties:
secretDependencyGroupId:
description: Id of the Secret Dependency Group to update.
type: integer
format: int32
secretDependencyGroupName:
description: Name for the Secret Dependency Group.
type: string
siteId:
description: Id of the Site to assign to the Dependency Group.
type: integer
format: int32
nullable: true
type: object
SecretDependencyGroupCreateArgs:
description: A Secret Dependency Group Object. A container for a logical collection of Secret Dependencies that use the same site.
properties:
secretDependencyGroupName:
description: The name of the Secret Dependency Group
type: string
siteId:
description: The Id of the Site that all dependencies in this group use
type: integer
format: int32
nullable: true
type: object
SecretDependencyRunScript:
description: The RunScript details of a Dependency that directly runs a Script
properties:
machineName:
description: The machine name that the Secret Dependency runs on
type: string
odbcConnectionArguments:
description: Connection arguments used for ODBC connections
items:
$ref: '#/components/schemas/SecretDependencyOdbcConnectionArg'
type: array
scriptArguments:
description: Parameter script arguments used by the script
items:
$ref: '#/components/schemas/SecretDependencyUniversalScriptArgument'
type: array
scriptId:
description: The Id of the script that the Secret Dependency runs. (If directly running a script)
type: integer
format: int32
nullable: true
scriptName:
description: The Name of the script that the Secret Dependency runs.
type: string
serviceName:
description: The service name of the Secret Dependency
type: string
type: object
DeletedModel:
description: Information about an object that was deleted
properties:
id:
description: ID of the deleted object
type: integer
format: int32
objectType:
description: Type of the deleted object
type: string
responseCodes:
description: List of response codes from the delete operation
items:
type: string
type: array
type: object
SecretDependencyUpdateArgs:
description: SecretDependencyUpdateArgs
properties:
active:
description: Whether or not the Secret Dependency is active
type: boolean
conditionDependencyId:
description: The Id of the dependency that will be looked at when Condition Mode is set to 'DEPENDENCYPASS', 'DEPENDENCYFAIL'. The Dependency must have a SortOrder lower than the current one.
type: integer
format: int32
nullable: true
conditionMode:
description: Condition Mode governs if this dependency's run relies on the result of other dependencies above it. The Default is ALWAYSRUN. Other values maybe 'All Pass', 'Any Fail', 'DEPENDENCYPASS', 'DEPENDENCYFAIL'.
type: string
dependencyTemplate:
$ref: '#/components/schemas/SecretDependencyTemplate'
description:
description: A description for the Secret Dependency
type: string
groupId:
description: The Id of the Dependency Group that contains the Secret Dependency. If set to 0 or a group id that does not exist on the secret, an error will be thrown.
type: integer
format: int32
id:
description: The Id of the Secret Dependency
type: integer
format: int32
machineName:
description: The machine name that the Secret Dependency runs on
type: string
privilegedAccountSecretId:
description: The Id of the Privileged Secret that the Secret Dependency will use to run
type: integer
format: int32
nullable: true
runScript:
$ref: '#/components/schemas/SecretDependencyRunScript'
secretId:
description: Read Only. The Id of the Secret that the Secret Dependency is assigned to. Cannot move a dependency to another secret by changing its SecretId.
type: integer
format: int32
secretName:
description: Read Only. The Name of the Secret that the Secret Dependency is assigned to
type: string
serviceName:
description: The service name of the Secret Dependency
type: string
settings:
description: 'The Settings used by the Secret Dependency. (Ex: WaitBeforeSeconds, Database, Port, SSHKeyDigest)'
items:
$ref: '#/components/schemas/SecretDependencySettingMapForDisplay'
type: array
sortOrder:
description: The sort order of the Secret Dependency in the group. Determines the order of execution of the dependencies within a group. If not set (default value 0), the dependency will be added at the end of the group. If less than zero the dependency will be added as the first dependency in the group and all other dependencies in the group will be adjusted.
type: integer
format: int32
sshKeySecretId:
description: The Id of the Secret containing the SSH key. (If dependency is tied to SSH key Secret
type: integer
format: int32
nullable: true
typeId:
description: The Id of the type of Secret Dependency
type: integer
format: int32
typeName:
description: Read Only. The name of the type of Secret Dependency
type: string
type: object
DependencyTemplate:
description: Dependency Template Object, used for Secret Dependencies
properties:
active:
description: Whether or not the Depenency Template is Active
type: boolean
dependencyChangerId:
description: The Depenency Template Changer Id
type: integer
format: int32
nullable: true
dependencyTypeId:
description: The Dependency Template Type Id
type: integer
format: int32
id:
description: The Dependency Template Id
type: integer
format: int32
name:
description: The Dependency Template Name
type: string
type: object
SecretDependencyGroup:
description: A Secret Dependency Group Object. A container for a logical collection of Secret Dependencies that use the same site.
properties:
id:
description: The Id of the Secret Dependency Group
type: integer
format: int32
name:
description: The name of the Secret Dependency Group
type: string
siteId:
description: The Id of the Site that all dependencies in this group use
type: integer
format: int32
nullable: true
siteName:
description: The Name of the Site that all dependencies in this group use
type: string
statusFailedCount:
description: Total Enabled Secret dependencies in this group with a Failed status
type: integer
format: int32
nullable: true
statusNotRunCount:
description: Total Enabled Secret dependencies in this group that have not yet run
type: integer
format: int32
nullable: true
statusSuccessCount:
description: Total Enabled Secret dependencies in this group with a Success status
type: integer
format: int32
nullable: true
totalDependencies:
description: Total Enabled Secret dependencies in this group
type: integer
format: int32
nullable: true
type: object
ILogicResultOfDependencyTemplateArray:
description: ILogicResultOfDependencyTemplate[]
properties:
model:
description: Model
items:
$ref: '#/components/schemas/DependencyTemplate'
type: array
type: object
DependencyScript:
description: Dependency Script Object, used for Secret Dependencies
properties:
arguments:
description: The Settings of the script used for arguments
items:
$ref: '#/components/schemas/SecretDependencyUniversalScriptArgument'
type: array
id:
description: The Script Id
type: integer
format: int32
name:
description: The name of the script
type: string
odbcConnectionArguments:
description: The connection arguments of the script if it is a SQL based script
items:
$ref: '#/components/schemas/SecretDependencyOdbcConnectionArg'
type: array
type: object
TaskProgress:
description: Information about the current status of a running task
properties:
errors:
description: A list of errors for the task
items:
$ref: '#/components/schemas/TaskError'
type: array
isComplete:
description: True if the task is complete
type: boolean
percentageComplete:
description: The estimated percentage complete of the task
type: integer
format: int32
status:
description: The current status of the task
type: string
taskIdentifier:
description: The task identifier
type: string
type: object
PagingOfSecretDependencySummary:
description: Specify paging and sorting options for querying records and returning results
properties:
batchCount:
description: Number of result batches available with current query options
type: integer
format: int32
currentPage:
description: Index of current result page
type: integer
format: int32
hasNext:
description: Whether there are any results in additional pages
type: boolean
hasPrev:
description: Whether there are any results in previous pages
type: boolean
nextSkip:
description: Correct value of 'skip' for the next page of results
type: integer
format: int32
pageCount:
description: Number of result pages available with current query options
type: integer
format: int32
prevSkip:
description: Correct value of 'skip' for the previous page of results
type: integer
format: int32
records:
description: Query results
items:
$ref: '#/components/schemas/SecretDependencySummary'
type: array
severity:
$ref: '#/components/schemas/Severity'
skip:
description: Number of records to skip before taking results
type: integer
format: int32
sortBy:
description: List of sort properties
items:
$ref: '#/components/schemas/Sort'
type: array
success:
description: Whether the query executed successfully
type: boolean
take:
description: Maximum number of records to include in results
type: integer
format: int32
total:
description: Total number of results available
type: integer
format: int32
type: object
AuthenticationFailedResponse:
description: Response object for authentication failures
required:
- message
properties:
message:
description: Error message
type: string
type: object
TaskError:
description: A description of an error for a task
properties:
errorMessage:
description: The error message
type: string
itemName:
description: The name of the item that had the error
type: string
type: object
UpdateSecretDependencyGroupArgs:
description: UpdateSecretDependencyGroupArgs
properties:
data:
$ref: '#/components/schemas/UpdateSecretDependencyGroupModel'
type: object
SecretDependencyGroupModel:
description: A Secret Dependency Group Object. A container for a logical collection of Secret Dependencies that use the same site.
properties:
name:
description: The name of the Secret Dependency Group
type: string
secretDependencyGroupId:
description: The Id of the Secret Dependency Group
type: integer
format: int32
secretId:
description: The Id of the Secret assigned to the Secret Dependency Group
type: integer
format: int32
siteId:
description: The Id of the Site that all dependencies in this group use
type: integer
format: int32
nullable: true
siteName:
description: The Name of the Site that all dependencies in this group use
type: string
statusFailedCount:
description: Total Enabled Secret dependencies in this group with a Failed status
type: integer
format: int32
nullable: true
statusNotRunCount:
description: Total Enabled Secret dependencies in this group that have not yet run
type: integer
format: int32
nullable: true
statusSuccessCount:
description: Total Enabled Secret dependencies in this group with a Success status
type: integer
format: int32
nullable: true
totalDependencies:
description: Total Enabled Secret dependencies in this group
type: integer
format: int32
nullable: true
type: object
ILogicResultOfSecretDependencyGroupArray:
description: ILogicResultOfSecretDependencyGroup[]
properties:
model:
description: Model
items:
$ref: '#/components/schemas/SecretDependencyGroup'
type: array
type: object
SecretDependencyUniversalScriptArgument:
description: Arguments used for Run Script Dependencies
properties:
name:
description: Name of the argument
type: string
type:
description: Argument type
type: string
value:
description: Argument value
type: string
type: object
SecretDependencyScanItemField:
description: Represents the ScanItemField used for Discovery dependency matching
properties:
id:
description: Id of the ScanItemField
type: integer
format: int32
name:
description: Name of the ScanItemField
type: string
parentName:
description: ScanItemField Parent name. Will Match Name if no parent is inherited.
type: string
value:
description: Value of the ScanItemField
type: string
type: object
securitySchemes:
BearerToken:
type: apiKey
description: 'Perform a POST request to `/oauth2/token`. It should include three form data parameters - `username`, `password`, and `grant_type`.The `grant_type` parameter should always have the value `password`.The access token returned should be included in the header of subsequent requests, like ''Authorization: Bearer token''. The token remains valid for a time period returned in the ''expires_in'' property (in seconds). For details, see the token request documentation.'
name: Authorization
in: header