SFTPコネクター

SFTP コネクターを使用すると、チェーンでコマンド を使用して、SFTP（Secure File Transfer Protocol）サーバ上のファイルやディレクトリを管理できます。たとえば、このコネクターを使用すると、テンプレートを使用してチェーンを作成し、SFTP サーバーからファイルを安全にダウンロードし、それを Wdata テーブル にアップロードすることができます。

前提条件

SFTPコネクターを使用するには、組織が独自のSFTPサーバーにアクセスする必要があります。Workivaは、これらのサーバーをホストすることも提供することもできません。

SFTPサーバーとの接続を保護するために、コネクターは基本的なユーザー名とパスワード認証、または公開キー/秘密キー認証のいずれかをサポートします。接続を設定するには、以下のものが必要です：

• サーバーのホスト名またはIPアドレス
• サーバーが実行されるポート
• サーバーへのアクセスに使用されるユーザー名
• ユーザー名の認証情報
  • 基本認証の場合、そのパスワード
  • 公開鍵認証の場合は、PEM または PPK 形式の秘密鍵ファイルと、そのパスワード（該当する場合）。秘密鍵の詳細はこちら。

SFTPコネクターを設定する

注： 組織のチェーンでコネクターを使用できるようにするには、まず最初に組織のセキュリティ管理者が構成から コネクターを有効にする必要があります。

1. チェーンビルダー から接続compare_arrows をクリックし、右上の作成 をクリックします。
2. BizApp Connection の下で、SFTP Connector とランナーを選択します。
   
3. [基本情報]で、接続の識別に役立つ一意の名前と説明を入力します。
4. 公開キー認証を使用する場合は、リソース で、サーバーの秘密キーファイルをアップロードします。 
5. [プロパティ]で、接続の詳細を入力します。
   

   プロパティ	詳細
   ホスト	SFTPサーバーのホスト名またはIPアドレス（ 34.23.34.45やsftp.example.netなど）を入力します。
   ポート	サーバーが実行されているポートを入力します。
   ユーザー名	サーバーへのログインに使用するユーザー名を入力します。
   パスワード	基本認証の場合は、ユーザー名 のパスワードを入力します。公開キー認証の場合は空白のままにします。
   秘密キー	公開キー認証の場合は、[リソース]にアップロードされた秘密鍵のファイル名を入力します。
   秘密キーのパスワード	公開キー認証の場合は、秘密キーファイルのパスワードを入力します。秘密キーにパスワードがない場合は、空白のままにします。
   接続タイムアウト	SFTP サーバーへの接続を待機する分数を入力します。サーバーの速度が遅い場合や負荷が高い場合は、大きな数値を入力します。

   注：機密性の高い資格情報はすべて自動的に暗号化され、高度な暗号化標準（AES）-256暗号化で保存されます。

6. 接続を使用する環境を選択し、[保存]をクリックします。
7. ネットワークで送信ドメインの許可リストが必要な場合は、Allow hosts and emails for Workiva ドキュメントに記載されている IP アドレスを許可します。
8. 接続をテストするには、SFTPコネクターの[ディレクトリをリスト化]コマンドでチェーンを作成して実行し、有効な出力が返されることを確認します。

トラブルシューティング

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でサポートされている。これらの行が欠けていたり、異なる用語が含まれていたりする場合は、キーをこのフォーマットに変換するか、新しいものを生成する必要がある。

建築