SFTP コネクターを使用すると、チェーンでコマンド を使用して、SFTP（Secure File Transfer Protocol）サーバ上のファイルやディレクトリを管理できます。たとえば、このコネクターを使用すると、テンプレートを使用してチェーンを作成し、SFTP サーバーからファイルを安全にダウンロードし、それを Wdata テーブル にアップロードすることができます。
前提条件
SFTPコネクターを使用するには、組織が独自のSFTPサーバーにアクセスする必要があります。Workivaは、これらのサーバーをホストすることもプロバイダーすることもできません。
SFTPサーバーとの接続を保護するために、コネクターは基本的なユーザー名とパスワード認証、または公開キー/秘密キー認証のいずれかをサポートします。接続を設定するには、以下のものが必要です：
- サーバーのホスト名またはIPアドレス
- サーバーが実行されるポート
- サーバーへのアクセスに使用されるユーザー名
- ユーザー名の認証情報
- 基本認証の場合、そのパスワード
- 公開キー認証の場合は、PEM または PPK 形式の秘密キーファイルと、そのパスワード（該当する場合）。秘密鍵の詳細はこちら。
SFTPコネクターを設定する
注： 組織のチェーンでコネクターを使用できるようにするには、まず最初に組織のセキュリティ管理者が構成から コネクターを有効にする必要があります。
- チェーンビルダー から接続 をクリックし、右上の作成 をクリックします。
-
コネクター 接続 で、SFTP コネクター とランナーを選択する。
- [基本情報]で、接続の識別に役立つ一意の名前と説明を入力します。
- 公開キー認証を使用する場合は、リソース で、サーバーの秘密キーファイルをアップロードします。
-
プロパティの下で、接続の詳細を入力します:
プロパティ 詳細 ホスト SFTPサーバーのホスト名またはIPアドレス（ 34.23.34.45やsftp.example.netなど）を入力します。 ポート サーバーが実行されているポートを入力します。 ユーザー名 サーバーへのログインに使用するユーザー名を入力します。 パスワード 基本認証の場合は、ユーザー名 のパスワードを入力します。公開キー認証の場合は空白のままにします。 秘密キー 公開キー認証の場合は、[リソース]にアップロードされた秘密鍵のファイル名を入力します。 秘密キーのパスワード 公開キー認証の場合は、秘密キーファイルのパスワードを入力します。秘密キーにパスワードがない場合は、空白のままにします。 接続タイムアウト SFTP サーバーへの接続を待機する分数を入力します。サーバーの速度が遅い場合や負荷が高い場合は、大きな数値を入力します。 注：機密性の高い資格情報はすべて自動的に暗号化され、高度な暗号化標準（AES）-256暗号化で保存されます。
- 接続を使用する環境を選択して、保存をクリックします。
- ネットワークで送信ドメインの許可リストが必要な場合は、Allow hosts and emails for Workiva ドキュメントに記載されている IP アドレスを許可します。
- 接続をテストするには、 SFTP コネクターのList Directory コマンド でチェーン を作成して実行し、有効な出力が返されることを確認します。
トラブルシューティング
SFTPサーバーへの接続が失敗した場合：
- コネクターの資格情報が正しいことを確認します。たとえば、FileZilla やWinSCP などの SFTP クライアント・アプリケーションを使用してサーバーに接続する場合にも、同じ認証情報を使用します。
- パスワードが「at」記号（@）で始まっていないことを確認してください。
- 接続がタイムアウトする場合は、接続タイムアウト を増やしてください。
- お客様のネットワークでドメインの送信許可リストが必要な場合は、Allow hosts and emails for Workiva ドキュメントに従ってください。
プライベートキー
SFTPクライアント・アプリケーションで公開キー/秘密キー・ペアを生成できない場合は、PuTTYgen やssh-keygen などのツールを使用してください。 秘密鍵については、以下の書式設定をサポートする：
- PuTTyが生成したキーで、通常拡張機能は.ppk で終わる。
- PKCS#1 標準の PEM 書式を使用した RSA キーで、通常拡張機能は.pemで終わります。
テキスト・エディターでRSAキーを表示することもできます。テキストが-----BEGIN RSA PRIVATE KEY----- と-----END RSA PRIVATE KEY----- を含む場合、これらの書式設定はWorkivaでサポートされます。これらの行が欠けていたり、異なる用語を含んでいたりする場合は、キーをこの書式設定に変換するか、新規生成する必要がある。