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

Operation ID:

BurnASecret

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

Operation ID:

CreateSecret

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

Operation ID:

GenerateSecret

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

Operation ID:

RetrieveSecret

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

Operation ID:

RetrieveMetadata

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

Operation ID:

RetrieveRecentMetadata

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.