クラウドプロファイル
単一のワークアトオンプレミスエージェント（OPA）は、複数のオンプレミスアプリケーションに接続できます。クラウドプロファイルを使用すると、ワークアトで直接接続を設定できます。このオプションは、新しいオンプレミスグループを作成する際に選択できます。
概要
- クラウドプロファイルを使用すると、オンプレミス接続をワークアトで直接構成できます。エージェントのシステム上のローカルな構成ファイルを手動で編集する必要はありません。
- クラウドプロファイルは、データベース、オンプレミスファイルシステム、SAP、Apache Kafka、一部のシークレット管理システムなどをサポートしています。
- OPAバージョン
2.15.0以降、クラウドプロファイルがサポートされています。 - 新しい接続を作成すると、ワークアトは自動的に構成の詳細をオンプレミスグループ内のすべてのエージェントに伝播します。
基本情報
クラウドプロファイルとは何ですか？
クラウドプロファイルは、オンプレミスエージェントの接続設定の新しい方法です。OPAバージョン2.15.0以降、オンプレミス接続をローカルなオンプレミスエージェントの構成ファイルを編集する代わりに、ワークアトで直接構成できるようになりました。これは、既存のプロセスの大幅な簡素化です。エージェントがインストールされているマシンに直接アクセスする必要はもはやありません。ただし、OPAグループ内のすべてのエージェントに構成の詳細が自動的に伝播されるようにしてください。gentは稼働しています。
接続を作成する際には、「Connection type」という入力フィールドが表示されます。これは既存のオンプレミスグループのリストです。クラウドコネクタの一部では、デフォルトの「Cloud」設定がある場合があります。クラウドプロファイルをサポートするオンプレミスグループを選択して、Workatoで直接接続を作成できるようにしてください。
以下は、クラウドプロファイルが選択された場合のSQL Server接続の例です。データベース接続プロパティを通常のクラウドコネクタと同様に設定できることがわかります。
SQL Serverクラウドプロファイル接続
どのようなシステムに接続できますか？
クラウドプロファイルは、次のシステムタイプでサポートされています：
WARNING
Google Secrets Manager、Azure Key Vaultなどの追加の設定を構成することは、まだクラウドプロファイルではサポートされていません。これらを使用したい場合は、接続プロファイルを確認してください。
新しい設定を適用するにはどうすればよいですか？
新しい接続を作成すると、詳細は特定のオンプレミスグループのすべてのエージェントに自動的に伝播されます。ほとんどの場合、すぐに行われますが、エージェントが更新された接続の詳細を取得するまでには時間がかかる場合があります。
データベースクラウドプロファイル
データベースクラウドプロファイルは、OPAがデータベースに接続するために使用する情報を提供します。
すべてのデータベースコネクタは、オンプレミスエージェントを介して接続するオプションを提供します。接続フィールドで、Connection typeというフィールドから希望のオンプレミスグループを選択してください。
クラウドプロファイルの設定を許可するオンプレミスグループを選択した後、通常のクラウドコネクタと同様に、Workatoで直接接続を設定できます。必要なフィールドを入力し、「Connect」をクリックしてください。
クラウドプロファイルを使用したデータベース接続
このセクションでは、以下の内容を説明します：
プロファイルのプロパティ
データベースクラウド接続プロファイルには、次のプロパティが含まれる場合があります：
| 名前 | タイプ | 説明 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| url/host | 必須 | データベースのホストアドレス。例：localhost。
注意：接続プロファイルを完全に構成するには、 urlまたはhostの値を指定する必要があります。
| ||||||||||||
| port | 必須 | データベースのポート番号。データベースの種類によっては、このプロパティを省略することができます。
たとえば、PostgreSQLデータベースはデフォルトでポート 5432を使用します。PostgreSQLがこのポートを使用している場合、接続プロファイルにportプロパティを追加する必要はありません。
デフォルトのポートは、サポートされるデータベースセクションにリストされています。 | ||||||||||||
| database | 必須 | データベースの名前。例：sales
注意： urlプロパティが指定されている場合、このプロパティは省略できます。
| ||||||||||||
| username | 必須 | データベースに接続するために使用されるデータベースユーザーのユーザー名。 | ||||||||||||
| password | 必須 | データベースユーザー（username）のパスワード。
| ||||||||||||
| ssl | オプション | SSL接続の設定オプション。SSLは次のデータベースでサポートされています：
|
サポートされているデータベース
以下の表に、OPAが現在サポートしているデータベースの情報が含まれています。
| データベース名 | デフォルトポート |
|---|---|
| Amazon Redshift | 5439 |
| JDBC互換データベース | |
| Microsoft SQL Server | 1433 |
| MySQL | 3306 |
| Oracle | 1521 |
| PostgreSQL | 5432 |
オンプレミスファイルクラウドプロファイル
オンプレミスファイルコネクタのドキュメントを参照してください。
SAPクラウドプロファイル
SAPコネクタは、ダイレクト接続またはメッセージサーバ接続の2つの接続タイプをサポートしています。
SAPのデフォルトポート
SAPコネクタはデフォルトで次のポートを使用します：
- SAPメッセージサーバ経由：36xx（xxはSAPシステム番号）
- SAPメッセージサーバなし、例：SAPへの直接呼び出し：48xx（SNCあり）および33xx（SNCなし）
さらに、SAPから提供されるREST ODataサービス、SOAP Webサービスなどを消費するためのHTTP（s）インバウンド通信の場合、デフォルトでポート番号は8000（HTTP）および44300（HTTPs）です。これらのポートがSAPでカスタム設定されている場合、ポート番号はSAPで次の手順で確認できます：
- ICMモニタ（SMICM）トランザクションに移動します。
- 「Goto Services」を選択して、ICMで構成されたサービスと関連するポートを表示します。
これらのポートがデフォルトと異なる場合は、Workatoサポートにお問い合わせください。
SAP - ダイレクト接続
以下はダイレクト接続タイプの例です。SAPシステムが直接アプリケーションサーバーとして公開されている場合にこの接続タイプを使用します。
オンプレミスSAPダイレクト接続を使用したクラウドプロファイル
| パラメーター | 説明 | 画像を拡大するにはクリックしてください |
|---|---|---|
| ゲートウェイホスト | DNS名またはIPアドレスのいずれかです。存在する場合、これはSAPホストへの直接接続を示します。xx.xx.xx.xxの形式になる場合があります。これは、直接接続しているSAPアプリケーションサーバーのIPアドレスです。これは、オンプレミスSAPアプリケーションサーバーにログインするために使用されるSAPログオンパッドで確認できます。 |  |
| システム番号 | 2桁のSAPシステム番号です。これは、アプリケーションサーバーが受信リクエストを待機している論理ポートを識別します。通常、システム番号はTCPポート33XX（XXはシステム番号）から見つけることができます。 |  |
| プログラムID | オプションです。レシピでIDOCを使用する場合にのみ必要です。これは、Tcode SM59でWorkatoにリンクされたRFC宛先に与えられたプログラムIDと一致します。これはデフォルトでWORKATOに設定されます。 |  |
| クライアント | Workatoに接続するために使用される実際のクライアント番号です。SAPログオンパッドでログインする際に使用するものと同じです。常に3桁の整数です。 |  |
| 言語 | オプションです。ログオン言語を表します。プロパティが提供されていない場合、ユーザーまたはシステムのデフォルト言語が使用されます。有効な値は2文字のISO言語コードまたは1文字のSAP言語コードです。 |  |
| ユーザー | WorkatoにプロビジョニングされたSAPユーザーです。バックグラウンドユーザーを使用し、ダイアログプロパティを無効にすることを推奨します。 |  |
| パスワード | SAPユーザーのパスワードです。 |  |
SAP - メッセージサーバー接続
以下はメッセージサーバー接続タイプの例です。SAPシステムがメッセージサーバーゲートウェイの背後にある場合には、この接続タイプを使用します。
クラウドプロファイルを使用したオンプレミスSAPメッセージサーバー接続
| パラメーター | 説明 | 画像をクリックして拡大 |
|---|---|---|
| メッセージサーバーホスト | xx.xx.xx.xx形式のメッセージサーバーホスト。これは接続しているメッセージサーバーのIPアドレスです。 |  |
| システムID | メッセージサーバーが所属するシステムのシステムID。接続エラーの場合はSAPノート52959を参照してください。 | |
| ログオングループ | (オプション) アプリケーションサーバーの論理グループ名。SAP Tcode SMLGで見つけることができます。 |  |
| プログラムID | オプション。レシピでIDOCを使用する場合にのみ必要です。これは、WorkatoとTcode SM59でリンクされたRFC宛先に与えられたプログラムIDと一致します。これは指定されていない場合、デフォルトでWORKATOに設定されます。 | |
| クライアント | Workatoに接続するために使用される実際のクライアント番号。SAP Logon Padでログインする際に使用するものと同じです。常に3桁の整数です。 | |
| 言語 | オプション。ログオン言語を表します。プロパティが提供されていない場合、ユーザーまたはシステムのデフォルト言語が使用されます。有効な値は、2文字のISO言語コードまたは1文字のSAP言語コードです。 | |
| ユーザー | Workato用にプロビジョニングされたSAPユーザー。バックグラウンドユーザーを使用し、ダイアログプロパティを無効にすることを推奨します。 | |
| パスワード | SAPユーザーパスワード。 | |
JMSクラウドプロファイル
クラウドプロファイルオンプレミスエージェントでは、次のJMSプロバイダーがサポートされています：
- Amazon Simple Queue Service
- Apache ActiveMQ
- Azure Service Bus
Amazon SQS
Amazon SQSに接続する際には、次の設定プロパティが必要です：
クラウドプロファイルamazon
| プロパティ名 | コメント |
|---|---|
| region | Amazon APIリージョン（例：'us-east-2'） |
| accessKey | Amazon APIアクセスキー |
| secretKey | Amazon APIシークレット |
メッセージを送信する前に、SQSキューが作成されていることを確認する必要があります。
Apache ActiveMQ
実行中のActiveMQブローカーに接続する場合、ブローカーURLの指定のみが必要です：
クラウドプロファイルactivemq
ActiveMQブローカーはエージェントに埋め込むことはできません。vm://ブローカー接続はサポートされていません。
Azure Service Bus
Azure Service BusはカスタムJMSプロバイダーを使用します。Azure Service Busに接続する際には、次の設定プロパティが必要です：
クラウドプロファイルcustom
| プロパティ名 | コメント | |------------------|-------------------------|------------------| | プロバイダー | カスタム | | クラス | org.apache.qpid.jms.JmsConnectionFactory | | remoteURI | amqps://host-name.servicebus.windows.net | | ユーザー名 | policy-name | | パスワード | primary-key |
ここからjarファイルをダウンロードし、lib_extフォルダ内に展開してください。
config.ymlファイルにクラスパスを追加してください。
server:
classpath: lib_extApache Kafka クラウドプロファイル
Apache Kafkaコネクタのドキュメントを参照してください。
Active Directory クラウドプロファイル
Active Directoryコネクタのドキュメントを参照してください。
コマンドラインスクリプト クラウドプロファイル
オンプレミスファイルコネクタのドキュメントを参照してください。
Last updated: