> For the complete documentation index, see [llms.txt](https://manual.dxable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manual.dxable.com/1password/vs-code.md). # VSコード用の1Password [1Password for VS Code は、 1Password CLI](https://developer.1password.com/docs/cli/)を活用して開発ワークフローを 1Password と統合するためのツール セットを提供します。 ### 必要条件 VS Code 拡張機能を使う前に、次のことを行う必要があります。 * [Mac](https://support.1password.com/get-the-apps/?mac)、[Windows](https://support.1password.com/get-the-apps/?windows)、または[Linux](https://support.1password.com/get-the-apps/?linux)用の 1Password をインストールします。 * [1Password CLI](https://developer.1password.com/docs/cli/get-started/#install)の最新バージョンをインストールします。 * [1Password CLI を 1Password アプリと統合します](https://developer.1password.com/docs/cli/get-started/#sign-in)。 ### [**インストール**](https://developer.1password.com/docs/vscode/#installation) 1Password for VS Code 拡張機能は、VS Code Marketplace または GitHub からインストールできます。 **VS Code マーケットプレイス** 1Password for VS Code 拡張機能をインストールする最適な方法は、拡張機能を自動的に最新の状態に維持する VS Code Marketplace を使うことです。 [**マーケットプレイスからインストール**](https://marketplace.visualstudio.com/items?itemName=1Password.op-vscode) **GitHub** 1Password for VS Code を GitHub から直接インストールすることもできます。このオプションは、自動更新を望まない、または拡張機能の古いバージョンを使う場合に適しています。GitHub リリース ページには、以前のリリースがすべてリストされています。 リリースには[VSIXファイルが含まれています](https://code.visualstudio.com/docs/editor/extension-marketplace#_install-from-a-vsix)VS Code にインストールできます。 [**GitHubからインストール**](https://github.com/1Password/op-vscode/releases) インストール後、拡張機能により 1Password アカウントと保管庫を選択するように求められます。 注意 拡張機能の機能を使うには、1Password アカウントと保管庫を選択する必要があります。 [コマンドパレット](https://code.visualstudio.com/api/ux-guidelines/command-palette)からアカウントと保管庫を後で選択できます: * ①**Command Palette**を開きます。 * ②1Password アカウントを選択するために、1Password: Choose account を入力します。 * ③Vault を選択するために、1Password: Choose vaultを入力します。 ### **Extension settings**[**​**](https://developer.1password.com/docs/vscode/#extension-settings) 1Password for VS Code には、構成できる設定がいくつかあります。1Password for VS Code の設定にアクセスするには: * ①**Code > Preferences > Settings**に移動します。 * ②**1Password**までスクロールするか、検索します。 次の表に拡張機能の設定を示します。 | **名前** | **設定ID** | **デフォルト値** | **詳細** | | -------------- | ----------------------------------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | アイテム: キャッシュ値 | 1password.items.cacheValues | true | 操Createを実行するときは CLI キャッシュを使用します。[キャッシュの](https://developer.1password.com/docs/cli/reference/#cache-item-and-vault-information)詳細については、こちらをご覧ください。 | | アイテム: パスワードレシピ | 1password.items.passwordRecipe | "letters,digits,symbols,32" | パスワードを生Createするときに使うレシピ。[パスワード レシピ](https://developer.1password.com/docs/cli/reference/management-commands/item/#generate-a-password)の詳細については、こちらをご覧ください。 | | アイテム: 秘密の参照を使う | 1password.items.useSecretReferences | true | [値をSaveおよび取得するには、シークレット参照構文を使用します。シークレット参照](https://developer.1password.com/docs/cli/secret-reference-syntax/)の詳細については、こちらをご覧ください。 | | 編集者: ストレージの提案 | 1password.editor.suggestStorage | true | 秘密のように見える場合は値をSaveすることを提案します。 | | デバッグ: 有効 | 1password.debug.enabled | false | デバッガー データをログに記録します。再ロードが必要です。 | ### **Feature** コードからシークレットが漏洩するのを防ぐ最善の防御策は、最初からシークレットをコード内に含めないことです。これを支援するため、シークレット参照を導入しました。VS Code 用 1Password は、シークレット参照を念頭に置いて構築されています。VS Code でシークレット参照を簡単に使用できるようにするための方法については[、さらに詳しく](https://developer.1password.com/docs/cli/secret-reference-syntax/)、また、以下をお読みください。 デフォルトでは、全ての操Createでアイテム フィールドを取得およびSaveするときにシークレット参照が使用されます。シークレット参照を使用しない場合は、「アイテム: シークレット参照を使う」設定をオフにして、代わりに生のフィールド値を挿入または保持することができます。 1Password VS Code プラグインを使うと、次のことが可能になります。 * [1PasswordにSave](https://developer.1password.com/docs/vscode/#save-in-1password) * [秘密の検出](https://developer.1password.com/docs/vscode/#detect-secrets) * [1Passwordから値を取得する](https://developer.1password.com/docs/vscode/#get-values) * [秘密をCreateする](https://developer.1password.com/docs/vscode/#create-secrets) * [秘密の参照をプレビューする](https://developer.1password.com/docs/vscode/#preview-secret-references) * [1Passwordの秘密を公開](https://developer.1password.com/docs/vscode/#open-secrets-in-1password) #### **Save in 1Password** 1Password 拡張機能を使うと、ドキュメント内のコードから 1PasswordにアイテムをSaveできます。 * ①ファイル内の公開されたシークレットを選択します。 * ② [Command Palette](https://code.visualstudio.com/api/ux-guidelines/command-palette)を開く。 * ③1Password: Save in 1Passwordを入力。 * ④アイテムの名前を入力します。 拡張機能は、各選択肢からアイテム名とフィールドを入力するように求めます。フィールド ラベルが電子メール、URL、またはクレジットカードのように見える場合は、自動的に推測しようとします。 アイテムをCreateして 1PasswordにSaveすると、拡張機能は選択内容をそのアイテムとフィールドを指す秘密の参照に置き換えます。 ヒント [コマンドパレットを](https://code.visualstudio.com/api/ux-guidelines/command-palette)開く前にファイル内の複数の項目を選択すると、複数の項目を同時にSaveできます。[VS Code での複数選択について詳しくは、こちらをご覧ください](https://code.visualstudio.com/docs/editor/codebasics#_multiple-selections-multicursor)。 #### **Detect secrets** 1Password for VS Code は、秘密のように見えるコードを自動的に監視し、1PasswordにSaveすることを提案します。動作は通常のファイルと .envファイルで若干異なります。 * 全ての通常ファイルにわたって既知の秘密パターンに一致する文字列をチェックします。 * ファイル内のキーワードを検査し.env、値が秘密であるかどうかを推測します。 拡張機能が一致するものを見つけると、"Save in 1Password" [CodeLens](https://learn.microsoft.com/en-us/visualstudio/ide/find-code-changes-and-other-history-with-codelens)が表示されます。クリックすると 1Passwordに秘密をSaveできる行の上にあります。 この機能は、"Editor: Suggest Storage"[設定](https://developer.1password.com/docs/vscode/#extension-settings)で制御できます。 #### **Get values from 1Password** 1Password for VS Code 拡張機能を使うと、コード内で 1Passwordに既に存在する値を使用できます。 * ① [Command Palette](https://code.visualstudio.com/api/ux-guidelines/command-palette)を開く。 * ②1Password: Get from 1Passwordを入力。 * ③アイテム名またはUUIDを入力します。 * ④使うフィールドを選択します。 拡張機能は、その項目とフィールドを指す秘密の参照を挿入します。 ヒント 使う保管庫、アイテム、フィールドが既にわかっていますか?secret referenceまたは op\://と入力してください。拡張機能には、秘密参照の個々の部分を入力するためのコード スニペットが用意されています。 #### **Create secrets** VS Code からプロジェクトのシークレットをCreateできます。 * ①文書内にカーソルを置きます。 * ②[Command Palette](https://code.visualstudio.com/api/ux-guidelines/command-palette)を開く。 * ③コマンドパレットに1Password: Generate passwordを入力します。 * ④アイテムの名前を入力してください。 1Password VS Code 拡張機能は、ランダムに生Createされたパスワードを使用してアイテムをCreateし、そのアイテムとフィールドを指す秘密参照をドキュメントに挿入します。 ヒント 「エディター: パスワード レシピ」[設定](https://developer.1password.com/docs/vscode/#extension-settings)を使用して、1Password for VS Code がパスワードの生Createに使うレシピをカスタマイズできます。 #### **Preview secret references** 1Password for VS Code は、開いているドキュメントを分析して秘密の参照を探し、見つかった秘密の参照に下線を付けます。また、個々の秘密の参照をプレビューしたり、秘密の参照値をファイルに読み込んだりすることもできます。 シークレット参照の詳細を検査するには: * ①秘密参照の上にカーソルを置きます。秘密参照の詳細がVS Code [CodeLens](https://learn.microsoft.com/en-us/visualstudio/ide/find-code-changes-and-other-history-with-codelens)に表示されます。\ [CodeLens](https://learn.microsoft.com/en-us/visualstudio/ide/find-code-changes-and-other-history-with-codelens)ウィンドウには、Create日など、シークレットに関する機密性のない情報のみが表示されます。機密性の高いフィールド (パスワードや SSH鍵など) の値は表示されません。 秘密の参照が実際の値に変換されたファイルの外観をプレビューするには: * ①ドキュメントの右上にあるロック解除アイコンを選択します。\ これにより、秘密の参照が実際の値に置き換えられたドキュメントの未Saveのコピーが開き、Saveまたは削除できるようになります。 **TIP** "1Password: Preview with secrets"コマンドを使用して、コマンドパレットからファイルのシークレットを表示することもできます。 #### **Open secrets in 1Password** 1PasswordアプリでOptionキーを押したままにすると、秘密の参照を開くことができます。、秘密の参照を選択します。 または、秘密の参照の上にカーソルを置き、[CodeLens](https://learn.microsoft.com/en-us/visualstudio/ide/find-code-changes-and-other-history-with-codelens)ウィンドウで**Follow link**を選択することもできます。 ### **Contributing and feedback** 1Password for VS Code はオープンソース プロジェクトです。 問題を発見した場合やフィードバックを共有したい場合は、[GitHub の問題を開いてください。](https://github.com/1Password/op-vscode/issues/new) 誰でも拡張機能に貢献できます。[貢献ガイドライン](https://github.com/1Password/op-vscode/blob/main/CONTRIBUTING.md)を参照してください。詳細についてはこちらをご覧ください。