mirror of
https://github.com/Skyvern-AI/skyvern.git
synced 2026-04-28 11:40:32 +00:00
suchintan's feedback + changelog (#4947)
Co-authored-by: Ritik Sahni <ritiksahni0203@gmail.com>
This commit is contained in:
parent
a4d9c9dd22
commit
59cd1e10bb
29 changed files with 885 additions and 148 deletions
|
|
@ -1,19 +1,30 @@
|
|||
---
|
||||
title: Password Credentials
|
||||
subtitle: Store login details and use them in automated workflows
|
||||
subtitle: Store login details and use them in automated sign-in flows
|
||||
slug: cloud/managing-credentials/password-credentials
|
||||
---
|
||||
|
||||
Password credentials store a username, password, and optional 2FA configuration. Reference them from Login blocks in your workflows, and Skyvern handles the entire sign-in flow — including entering 2FA codes.
|
||||
Password credentials store a username, password, and optional 2FA configuration. Reference them from [Login blocks](/cloud/building-workflows/configure-blocks) in your workflows, and Skyvern handles the entire sign-in flow, including entering 2FA codes.
|
||||
|
||||
## Creating a password credential
|
||||
|
||||
Click **+ Add → Password** from the Credentials page. Three fields: **Name** (a label like "Salesforce Production"), **Username or Email**, and **Password**. The password field has an eye icon to toggle visibility.
|
||||
<Steps>
|
||||
<Step title="Open the Add dialog">
|
||||
Click **+ Add → Password** from the Credentials page.
|
||||
</Step>
|
||||
<Step title="Fill in your login details">
|
||||
Enter a **Name** (a label like "Salesforce Production"), **Username or Email**, and **Password**. The password field has an eye icon to toggle visibility.
|
||||
</Step>
|
||||
<Step title="Configure 2FA (optional)">
|
||||
Expand the **Two-Factor Authentication** accordion to set up automated 2FA handling. See [below](#adding-two-factor-authentication) for details.
|
||||
</Step>
|
||||
<Step title="Save">
|
||||
Click **Save**. The credential is immediately available for use in workflows.
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
<img src="/images/cloud/credentials-add-password.png" alt="Add password credential modal" />
|
||||
|
||||
Save the credential and it's ready to use in a workflow.
|
||||
|
||||
## Adding two-factor authentication
|
||||
|
||||
If the site requires 2FA, expand the **Two-Factor Authentication** accordion below the password fields. Three options, depending on how the site delivers codes:
|
||||
|
|
@ -22,7 +33,7 @@ If the site requires 2FA, expand the **Two-Factor Authentication** accordion bel
|
|||
|
||||
| Method | How it works |
|
||||
|--------|-------------|
|
||||
| **Authenticator App** | Paste the TOTP secret key and Skyvern generates codes locally on demand — fully automated, no delay. Preferred when the site supports it. |
|
||||
| **Authenticator App** | Paste the TOTP secret key and Skyvern generates codes locally on demand. Fully automated with no delay. Preferred when the site supports it. |
|
||||
| **Email** | Provide the email address that receives codes. Skyvern waits for you to push the code via the [2FA tab](/cloud/managing-credentials/totp-setup) or API. Identifier auto-fills from the Username field. |
|
||||
| **Text Message** | Provide the phone number that receives codes. Same push-based flow as Email. |
|
||||
|
||||
|
|
@ -35,26 +46,23 @@ The secret key is the base32-encoded string behind the QR code you'd scan in an
|
|||
|
||||
- **Bitwarden**: Edit the login → TOTP field → copy the key
|
||||
- **1Password**: Edit the login → One-Time Password → copy the secret
|
||||
- **LastPass**: Edit the login → Advanced Settings → copy the TOTP secret
|
||||
- **Site settings**: Many sites show a "Can't scan?" link during 2FA setup that reveals the text key
|
||||
|
||||
If you only have a QR code, decode it to extract the `secret=` parameter from the `otpauth://totp/...?secret=BASE32KEY` URI.
|
||||
</Accordion>
|
||||
|
||||
## Using credentials in workflows
|
||||
## Using credentials in a workflow
|
||||
|
||||
The most common pattern is a **Login block**. Select the stored credential from the dropdown, and Skyvern navigates to the login page, enters the username and password, handles 2FA if configured, and waits for the page to confirm authentication. See [Block Reference → Login](/cloud/building-workflows/configure-blocks) for details.
|
||||
|
||||
For workflows that need different accounts at runtime, use a **Credential parameter** (type: `credential_id`). When someone runs the workflow, they pick which credential to use from a dropdown.
|
||||
|
||||
You can also pull credentials from **Bitwarden**, **1Password**, or **Azure Key Vault**. See [External Providers](/cloud/managing-credentials/credentials-overview#external-credential-providers).
|
||||
In the Login block configuration, select a stored credential from the dropdown. Skyvern fills in the username and password automatically, and handles 2FA if configured.
|
||||
|
||||
## Managing credentials
|
||||
|
||||
Stored credentials show the name, credential ID, username (plain text), password (always masked), and 2FA method if configured.
|
||||
|
||||
<Warning>
|
||||
Credentials can't be edited after creation. To change a password, delete the old credential and create a new one.
|
||||
</Warning>
|
||||
<Note>
|
||||
To edit a credential, click the **pencil icon** on its row. For security, saved passwords and secrets are never retrieved, so you must re-enter all sensitive fields when updating.
|
||||
</Note>
|
||||
|
||||
<CardGroup cols={2}>
|
||||
<Card
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue