# クラウドプロファイル

概要

クラウドプロファイルを使用すると、オンプレミス接続をワークアトで直接構成できます。エージェントのシステム上のローカルな構成ファイルを手動で編集する必要はありません。
クラウドプロファイルは、データベース、オンプレミスファイルシステム、SAP、Apache Kafka、一部のシークレット管理システムなどをサポートしています。
OPAバージョン2.15.0以降、クラウドプロファイルがサポートされています。
新しい接続を作成すると、ワークアトは自動的に構成の詳細をオンプレミスグループ内のすべてのエージェントに伝播します。

単一のワークアトオンプレミスエージェント（OPA）は、複数のオンプレミスアプリケーションに接続できます。クラウドプロファイルを使用すると、ワークアトで直接接続を設定できます。このオプションは、新しいオンプレミスグループを作成する際に選択できます。

# クラウドプロファイルとは何ですか？

クラウドプロファイルは、オンプレミスエージェントの接続設定の新しい方法です。OPAバージョン2.15.0以降、オンプレミス接続をローカルなオンプレミスエージェントの構成ファイルを編集する代わりに、ワークアトで直接構成できるようになりました。これは、既存のプロセスの大幅な簡素化です。エージェントがインストールされているマシンに直接アクセスする必要はもはやありません。ただし、OPAグループ内のすべてのエージェントに構成の詳細が自動的に伝播されるようにしてください。gentは稼働しています。

接続を作成する際には、「Connection type」という入力フィールドが表示されます。これは既存のオンプレミスグループのリストです。クラウドコネクタの一部では、デフォルトの「Cloud」設定がある場合があります。クラウドプロファイルをサポートするオンプレミスグループを選択して、Workatoで直接接続を作成できるようにしてください。

以下は、クラウドプロファイルが選択された場合のSQL Server接続の例です。データベース接続プロパティを通常のクラウドコネクタと同様に設定できることがわかります。

SQL Serverクラウドプロファイル接続

# どのようなシステムに接続できますか？

クラウドプロファイルは、次のシステムタイプでサポートされています：

データベース
オンプレミスファイルシステム
SAP
Javaメッセージングサービス
Apache Kafka
Active Directory
コマンドラインスクリプト

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は次のデータベースでサポートされています：

MySQL - バージョン5.7以上
PostgreSQL - バージョン11.x以上

次のプロパティを含みます：

名前	タイプ	説明
サーバー証明書	オプション	.pem形式のX509サーバー証明書。
SSL証明書	オプション	.pem形式のX509クライアント証明書。
SSL証明書キー	オプション	.pem形式のRSAクライアントキー。

# サポートされているデータベース

以下の表に、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

ここ (opens new window)からjarファイルをダウンロードし、lib_extフォルダ内に展開してください。

config.ymlファイルにクラスパスを追加してください。

server:
 classpath: lib_ext

# Apache Kafka クラウドプロファイル

Apache Kafkaコネクタのドキュメントを参照してください。

# Active Directory クラウドプロファイル

Active Directoryコネクタのドキュメントを参照してください。

# コマンドラインスクリプトクラウドプロファイル