Compartilhar via


One-Time Secret (Independent Publisher) (Preview)

One-Time Secret is a way to share sensitive information without storing them. If you use a one-time link instead, the information persists for a single viewing which means it can't be read by someone else later. This allows you to send sensitive information in a safe way knowing it's seen by one person only. Think of it like a self-destructing message.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Aldo Gillone
URL https://github.com/alduzzen1985/One-Time-Secet-Connector/
Email aldogillone@gmail.com
Connector Metadata
Publisher Aldo Gillone
Categories Security
Privacy policy https://onetimesecret.com/info/privacy
Website https://onetimesecret.com/

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
Email securestring The Email for this api True
API Key securestring The API Key provided True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Burn Secret

Burn a secret that has not been read yet.

Create a Secret

Use this method to store a secret value.

Generate a Secret

Generate a short, unique secret. This is useful for temporary passwords, one-time pads, salts, etc.

Retrieve a Secret

Retrieve a Secret

Retrieve Metadata

Every secret also has associated metadata. The metadata is intended to be used by the creator of the secret (i.e. not the recipient) and should generally be kept private. You can safely use the metadata key to retrieve basic information about the secret itself (e.g. if or when it was viewed) since the metadata key is different from the secret key.

Retrieve Recent Metadata

Retreive a list of recent metadata.

Burn Secret

Burn a secret that has not been read yet.

Parameters

Name Key Required Type Description
Metadata Key
METADATA_KEY True string

Metadata Key

Returns

Name Path Type Description
Customer ID
state.custid string

This is you

Metadata key
state.metadata_key string

The unique key for the metadata. DO NOT share this.

Secret Key
state.secret_key string

The unique key for the secret you create. This is key that you can share.

Time-To-Live
state.ttl integer

The time-to-live (in seconds) that was specified (i.e. not the time remaining)

Metadata TTL
state.metadata_ttl integer

The remaining time (in seconds) that the metadata has left to live.

Secret Time-To-Live
state.secret_ttl integer

The remaining time (in seconds) that the secret has left to live.

State
state.state string

State of the Secret

Updated
state.updated integer

ditto, but the time it was last updated.

Created
state.created integer

Time the secret was created in unix time (UTC)

recipient
state.recipient array of

recipient

Secret Short Key
secret_shortkey string

Secret Short Key

Create a Secret

Use this method to store a secret value.

Parameters

Name Key Required Type Description
Secret value
secret True string

The secret value which is encrypted before being stored. There is a maximum length based on your plan that is enforced (1k-10k).

Time To Leave
ttl string

The maximum amount of time, in seconds, that the secret should survive (i.e. time-to-live). Once this time expires, the secret will be deleted and not recoverable.

Pass Phrase
passphrase string

A string that the recipient must know to view the secret. This value is also used to encrypt the secret and is bcrypted before being stored so we only have this value in transit.

E-mail to notify
recipient string

an email address. We will send a friendly email containing the secret link (NOT the secret itself).

Returns

Name Path Type Description
Custiomer id
custid string

this is you

Metadata key
metadata_key string

The unique key for the metadata. DO NOT share this.

Secret Key
secret_key string

The unique key for the secret you create. This is key that you can share.

TTL
ttl integer

The time-to-live (in seconds) that was specified (i.e. not the time remaining)

Metadata TTL
metadata_ttl integer

The remaining time (in seconds) that the metadata has left to live.

Secret TTL
secret_ttl integer

The remaining time (in seconds) that the secret has left to live.

state
state string

state

Updated
updated integer

ditto, but the time it was last updated.

created
created integer

Time the secret was created in unix time (UTC)

recipient
recipient array of

recipient

Passphrase required
passphrase_required boolean

If a passphrase was provided when the secret was created, this will be true. Otherwise false, obviously.

Generate a Secret

Generate a short, unique secret. This is useful for temporary passwords, one-time pads, salts, etc.

Parameters

Name Key Required Type Description
Pass Phrase
passphrase string

A string that the recipient must know to view the secret. This value is also used to encrypt the secret and is bcrypted before being stored so we only have this value in transit.

Time To Leave
ttl integer

Maximum amount of time, in seconds, that the secret should survive

Recipient
recipient string

An email address. We will send a friendly email containing the secret link (NOT the secret itself).

Returns

Name Path Type Description
Customer ID
custid string

This is you

Generated Value
value string

Generated Value. DO NOT share this.

Metadata key
metadata_key string

The unique key for the metadata. DO NOT share this.

Secret key
secret_key string

The unique key for the secret you create. This is key that you can share..

Time-to-Live
ttl integer

The time-to-live (in seconds) that was specified (i.e. not the time remaining)

Updated
updated integer

Ditto, but the time it was last updated.

Created
created integer

Time the secret was created in unix time (UTC)

Retrieve a Secret

Retrieve a Secret

Parameters

Name Key Required Type Description
Secret Key
SECRET_KEY True string

Secret Key

Pass Phrase
passphrase string

Pass Phrase

Returns

Name Path Type Description
Value
value string

The actual secret. It should go without saying, but this will only be available one time.

Secret Key
secret_key string

The unique key for the secret you create. This is key that you can share.

Retrieve Metadata

Every secret also has associated metadata. The metadata is intended to be used by the creator of the secret (i.e. not the recipient) and should generally be kept private. You can safely use the metadata key to retrieve basic information about the secret itself (e.g. if or when it was viewed) since the metadata key is different from the secret key.

Parameters

Name Key Required Type Description
Metadata Key
METADATA_KEY True string

The unique key for the metadata. DO NOT share this.

Returns

Name Path Type Description
Customer ID
custid string

this is you

Metadata Key
metadata_key string

The unique key for the secret you created. This is key that you can share.

Secret Key
secret_key string

The unique key for the secret you created. This is key that you can share.

Time-To-Live
ttl integer

The time-to-live that was specified (i.e. not the time remaining)

Metadata Time-To-Live
metadata_ttl integer

The remaining time (in seconds) that the metadata has left to live.

Secret Time-To-Live
secret_ttl integer

The remaining time (in seconds) that the secret has left to live.

State
state string

State of the Secret

Updated
updated integer

ditto, but the time it was last updated.

Created
created integer

Time the metadata was created in unix time (UTC)

recipient
recipient array of

recipient

Passphrase required
passphrase_required boolean

If a passphrase was provided when the secret was created, this will be true. Otherwise false, obviously.

Retrieve Recent Metadata

Retreive a list of recent metadata.

Returns

Name Path Type Description
array of object
Customer Id
custid string

this is you

Metadata key
metadata_key string

The unique key for the metadata. DO NOT share this.

Time-To-Live
ttl integer

The time-to-live that was specified (i.e. not the time remaining)

Metadata Time-To-Live
metadata_ttl integer

The remaining time (in seconds) that the metadata has left to live.

Secret Time-To-Live
secret_ttl integer

The remaining time (in seconds) that the secret has left to live.

state
state string

state

Updated
updated integer

ditto, but the time it was last updated.

Created
created integer

Time the secret was created in unix time (UTC)

recipient
recipient array of

recipient

Received
received integer

Time the secret was received.