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/ |
| 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 |
|---|---|---|---|
| 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. |