Version: 3.25

DSM Methods

Introduction

The senhasegura DevOps Secret Management (DSM) offers a rapid and secure way for tools and applications to request confidential information such as secrets, credentials and other sensitive data that are used on DevOps lifecycle.

The purpose of this section is to provide guidance for DevOps teams that need integration with senhasegura to manage all secrets used on their pipeline.

In this section, the following DevOps functions will be covered:

Request a secret to be used on an application
Provision a new credential to be used on an applications
Deprovision a credential

Method

The senhasegura web integration service has a method for query secrets stored in the application.

Query secret

GET https://vault_url/iso/dapp/application

The application method queries all secrets linked to an application authorization.

Response

Field	Type	Description
name	String	Application name
description	String	Application description
tags	String	Tags that identify the application
system	String	Secret system
environment	String	Secret environment
secret _id	Integer	Secret ID
secret_name	String	Secret Name
identity	String	Secret identifier
version	String	Secret version
expiration_date	Date/Time	Secret expiration date
engine	String	Secret engine
data	String	Secret values

{
    "response": {
        "status": 200,
        "mensagem": "Application 5",
        "erro": false,
        "message": "Application 5",
        "error": false
    },
    "application": {
        "name": "postman",
        "description": null,
        "tags": [
            ""
        ],
        "system": "back",
        "environment": "test",
        "secrets": [
            {
                "secret_id": "106",
                "secret_name": "application5",
                "identity": "application5",
                "version": "",
                "expiration_date": "",
                "engine": "Kubernetes",
                "data": [
                    {
                        "hostname": "application5_v_test",
                        "username": "ADMIN_V_USR",
                        "password": "ADMIN_V_PW",
                        "additional_information": "ADMIN_V_SCHEMA",
                        "ip": "app.application.com"
                    },
                    {
                        "access_key_id": "LKU5YC6QWAT487S4KEK",
                        "secret_access_key": "sack10821du07f9sacfsdaasdf",
                        "TTL": null
                    },
                    {
                        "my_key_name": "my_key_value",
                        "my_key_name_2": "my_key_value_2"
                    }
                ]
            }
        ]
    }
}

Response with SSH as secret

{
    "response": {
        "status": 201,
        "mensagem": "Secret created successfully.",
        "erro": false,
        "cod_erro": 0,
        "message": "Secret created successfully.",
        "error": false,
        "error_code": 0
    },
    "application": {
        "name": "postman",
        "description": "teste",
        "tags": [
            "abc",
            "def",
            "teste"
        ],
        "system": "inetconfig",
        "environment": "stage",
        "secrets": [
            {
                "secret_id": "3",
                "secret_name": "state_secret",
                "identity": "cart/americanas/npf/cassandra",
                "version": "205",
                "description": "Chamada de API",
                "expiration_date": "2022-08-18 11:10:00",
                "engine": "GitLab",
                "data": [
                    {
                        "HOSTNAME": "AWS Gateway",
                        "USERNAME": "user",
                        "CONNECTION_STRING": "mongodb://api-server/auth",
                        "private_key": "An error occurred while encrypting the text",
                        "public_key": "ssh-rsa dsafffasdfads+FoCrHU0ZZSeIK4rkoB+O55qz0Ns527ROxwslDwn0TsLMwGTr3L4QCmnihmBOF7PlX7027DtldO0gFswdwPDKynAK2Crn6bcBQg8PAw6tUAM7/QWFosW13JzrbDz6gUV+DXMilQPUIJ7CsdfmubE/jFzJ/aBN2f+5mK6Xf3ghvGLo4+PriAUZO/x1XEm4+destdfsadfasafsd+GwwgFYVvTMOUYjjHYcqKjjqah8F8ltN5aN+9P3cwWlbnO/RoORHgpavBcOMDBXOHHtWwT4qSWNZJ4/BIeBr3ACTjqoUrDdAsgr2u+i46l user\n",
                        "PASSWORD": "sbgiXZU+5qmejm/kYqb+asdffsdaafsd/PPjcBxvr9S0jS1+F7Qc2HZ0N0PqQFw4I0p2X943+Y4wYR8RXSgFqtxuEbYBMv7TJijqIA0fVWkVNdCaqRVIpIbdtGjpUuf+asdffdsa/maPt0T9KfkKJSPh9WY2O8oRkCpRays8Lihp3ZP+asdffsd==",
                        "ip": "aws.amazon.com"
                    }
                ]
            }
        ]
    }
}

Create or update a secret

POST https://vault_url/iso/sctm/secret

Create or update a secret.

Parâmetros

Field	Type	Description
Name	String	Secret Name
Identity	String	Secret's Identity
Expiration_Date	Date/time	Secret's deactivation date
Description	String	Secret Description
Engine	String	Secret's Engine must be a valid engine registered in senhasegura
renew_cloud_time	Int	Sets the time to renew cloud access keys in minutes. If omitted is ignored, but with empty array, will disable auto-renew
renew_credential_time	Int	Set the time to renew credentials in minutes. If omitted is ignored, but with empty array, will disable auto-renew
renew_ephemeral_credential_time	Int	Sets the time to renew ephemeral credentials in minutes. If omitted is ignored, but with empty array, will disable auto-renew
Date*	String	Must be valid base64 encoded json as in Data Example

Data Example

{
    access_keys:
    [
        {
            access_key:
            {
                type: "aws",
                fields:
                {
                    access_key_id: "AKIAREVEFYNPPAOT3PF6",
                    access_key_id_label: "AWS_ACCESS_KEY_ID",
                    secret_access_key: "AStrongPass",
                    secret_access_key_label: "AWS_SECRET_ACCESS_KEY",
                }
            }
        },
    ],
    credentials:
    [
        {
            credential:
            {
                fields:
                {
                    user: "cred_a",
                    user_label: "USERNAME",
                    host: "aws.amazon.com",
                    host_label: "HOSTNAME",
                    password: "StrongPass",
                    password_label: "PASSWORD",
                    additional_information: "mongodb://api-server/auth",
                    additional_information_label: "CONNECTION_STRING",
                }
            }
        },
        {
            credential:
            {
                fields:
                {
                    user: "an_username",
                    user_label: "USERNAME",
                    host: "an_ip",
                    host_label: "HOSTNAME",
                    password: "StrongPass",
                    password_label: "PASSWORD",
                    additional_information: "the_additional_info",
                }
            }
        },
    ]
}

Response

Field	Type	Description
name	String	Application Name
description	String	Application Description
tags	String	Application tag
system	String	Secret System
environment	String	Secret Environment
secret _id	Integer	Secret ID
secret_name	String	Secret Name
identity	String	Secret Identifier
version	String	Secret version
expiration_date	Date/Time	Secret Expiration Date
engine	String	Secret Engine
data	String	Secret Values

{
    "response": {
        "status": 201,
        "mensagem": "Secret created successfully.",
        "erro": false,
        "cod_erro": 0,
        "message": "Secret created successfully.",
        "error": false,
        "error_code": 0
    },
    "application": {
        "name": "postman",
        "description": "teste",
        "tags": [
            "abc",
            "def",
            "teste"
        ],
        "system": "inetconfig",
        "environment": "stage",
        "secrets": [
            {
                "secret_id": "7",
                "secret_name": "state_secret",
                "identity": "example_2",
                "version": "2",
                "description": "Chamada de API",
                "expiration_date": "2022-08-18 11:10:00",
                "engine": "GitLab",
                "data": [
                    {
                        "AWS_ACCESS_KEY_ID": "AKIAREVEFYNPPAOT3PF6",
                        "AWS_SECRET_ACCESS_KEY": "fd/ZmmciA4d8CqkXIzK8l2oWrUY7+fds/aasdf+WwP5cTAQW5mpr9XAHiGS1zkRQEUvJ7pta3ABrAeRt3QH6UuuGwPunATFdhFvAG/lTlrby6z+dfdfas/cKUzQpHpQE0UNxNwzCauRpbPDOUzMnpRopbyGQDzdkN0uXSXJLh3kraX+/qQ/v3riN1pB+Wuzd4zvxLfeH6oA==",
                        "TTL": ""
                    },
                    {
                        "APP": "Postman",
                        "CONNECTION_STRING": "mongodb://api-server/auth",
                        "DATE": "date",
                        "HOSTNAME": "an_ip",
                        "PASSWORD": "StrongPass",
                        "USERNAME": "an_username"
                    }
                ]
            }
        ]
    }
}

Create or update an application

POST https://vault_url/iso/dapp/application

Create or update an application.

Parameters

Field	Type	Description
Name	String	Secret Name
Identity	String	Secret Identity
Expiration_Date	Date/Time	Secret's deactivation date
Description	String	Secret Description
Engine	String	Secret's Engine must be a valid engine registered in senhasegura
renew_cloud_time	Int	Set renewal time to cloud access keys in minutes. If omitted will disable auto-renewal
renew_credential_time	Int	Set renewal time to credentials in minutes. If omitted will disable auto-renewal
renew_ephemeral_credential_time	Int	Set renewal time to ephemeral credentials in minutes. If omitted will disable auto-renewal
Data*	String	Must be valid base64 encoded json

Response

Field	Type	Description
Unique key*	String	Unique identifier of an authorization, if the value is sent, the environment and system fields will be ignored for the authorization search
Application*	String	Application Name
System*	String	System to which the authorization belongs, used for consultation, only used for writing in new authorizations
Environment*	String	Environment to which the authorization belongs, used for consultation, only used for writing in new authorizations
Description	String	Application description
Authentication Method	String	Application authentication and authorization method, this parameter is only used when creating the application, when updating it is ignored
Line of Business	String	Defines the application's line of business
Application Type	String	Defines the application type
Tags	String[]	Define applications tags
Amazon ARNs (for AWS Authentication)	String[]	Define application ARNs
Cloud Dynamic Provising profile	String[]	Defines application cloud dynamic provisioning profiles
Credential Dynamic Provising Profile (device and profile)	Array	Defines application ephemeral credential dynamic provisioning profiles
Authorized Resources	String[]	Defines the authorized resources of the authorization, used only when creating the authorization
Expiration date/time	Date/Time	Secret expiration date, used only when creating the authorization
Enable Encryption of sensitive information?	Boolean	Defines encryption of sensitive authorization data, used only in authorization creation
Allowed IPs	String[]	Defines the allowed IPs of the authorization, used only when creating the authorization
Allowed HTTPS refers	String[]	Defines the allowed HTTP referrers of the authorization, used only when creating the authorization
Certificate Fingerprint	String	Defines the fingerprint of the authorization certificate, used only when creating the authorization

Response

Field	Type	Description
id	String	Application ID
signature	String	Application Signature

{
    "response": {
        "status": 200,
        "mensagem": "Application updated: (4) postman | Authorization found: (6)",
        "erro": false,
        "cod_erro": 0,
        "message": "Application updated: (4) postman | Authorization found: (6)",
        "error": false,
        "error_code": 0
    },
    "id": "applicationID",
    "signature": "signature"
}

Provision a credential

POST https://vault_url/iso/coe/dapp/provision

Create a new credential secret to be used on a container

Parameters

Field	Type	Description	Required
pod_name	String	Name of the pod that will use the credential	Yes
deploy	String	Name of the deploy that will use the credential	Yes
namespace	String	Namespace of the container that will use the credential	Yes

Response

Field	Type	Description
name	String	Application name
description	String	Application description
tags	String	Tags that identify the application
system	String	Sistema da secret
environment	String	Ambiente de secret
secret_id	Integer	ID da secret
secret_name	String	Nome da secret
identity	String	Identificador da secret
version	String	Versão da secret
expiration_date	Date/Time	Data de expiração da secret
engine	String	Engine da secret
data	String	Valor da secret

{
    "response": {
        "status": 200,
        "mensagem": "Application 6",
        "erro": false
    },
    "application": {
        "name": "runb",
        "description": null,
        "tags": [
            ""
        ],
        "system": "senhasegura",
        "environment": "lab",
        "secrets": [
            {
                "secret_id": "3",
                "secret_name": "secure-demo",
                "identity": "secure-demo",
                "version": "",
                "expiration_date": "",
                "engine": "Kubernetes",
                "data": {
                    "APP_VAR1": "fX6v8vh7TADY",
                    "APP_VAR2": "vlln0XkBNWIk",
                    "APP_VAR3": "7qWgm1EBFnQb",
                    "APP_DB_PASSWORD": "4i8Vm0khqTWs",
                    "APP_SECRET": "GSePWjXyd91K"
                }
            }
        ]
    }
}

Deprovision a credential

POST https://vault_url/iso/coe/dapp/deprovision

Deprovision a credential secret to be used on a container

Parameters

Field	Type	Description	Required
pod_name	String	Name of the pod that will use the credential	Yes
deploy	String	Name of the deploy that will use the credential	Yes
namespace	String	Namespace of the container that will use the credential	Yes
secret_id	Integer	Secret ID	Yes

DSM Methods

Introduction​

Method​

Query secret​

Response​

Response with SSH as secret​

Create or update a secret​

Parâmetros​

Data Example​

Response​

Create or update an application​

Parameters​

Response​

Response​

Provision a credential​

Parameters​

Response​

Deprovision a credential​

Parameters​

Introduction

Method

Query secret

Response

Response with SSH as secret

Create or update a secret

Parâmetros

Data Example

Response

Create or update an application

Parameters

Response

Response

Provision a credential

Parameters

Response

Deprovision a credential

Parameters