# クラウドプロファイル

概要

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

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


# 基本情報

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

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

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

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

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は次のデータベースでサポートされています:
  • 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で次の手順で確認できます:

  1. ICMモニタ(SMICM)トランザクションに移動します。
  2. 「Goto Services」を選択して、ICMで構成されたサービスと関連するポートを表示します。

これらのポートがデフォルトと異なる場合は、Workatoサポートにお問い合わせください。

# SAP - ダイレクト接続

以下はダイレクト接続タイプの例です。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に設定されます。 プログラムID
クライアント Workatoに接続するために使用される実際のクライアント番号です。SAPログオンパッドでログインする際に使用するものと同じです。常に3桁の整数です。 クライアント
言語 オプションです。ログオン言語を表します。プロパティが提供されていない場合、ユーザーまたはシステムのデフォルト言語が使用されます。有効な値は2文字のISO言語コードまたは1文字のSAP言語コードです。 言語
ユーザー WorkatoにプロビジョニングされたSAPユーザーです。バックグラウンドユーザーを使用し、ダイアログプロパティを無効にすることを推奨します。 ユーザー
パスワード 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に設定されます。 プログラムID
クライアント 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 クラウドプロファイルamazon

プロパティ名 コメント
region Amazon APIリージョン(例:'us-east-2')
accessKey Amazon APIアクセスキー
secretKey Amazon APIシークレット

メッセージを送信する前に、SQSキューが作成されていることを確認する必要があります。

# Apache ActiveMQ

実行中のActiveMQブローカーに接続する場合、ブローカーURLの指定のみが必要です:

クラウドプロファイルactivemq クラウドプロファイルactivemq

ActiveMQブローカーはエージェントに埋め込むことはできません。vm://ブローカー接続はサポートされていません。

# Azure Service Bus

Azure Service BusはカスタムJMSプロバイダーを使用します。Azure Service Busに接続する際には、次の設定プロパティが必要です:

クラウドプロファイルcustom クラウドプロファイル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コネクタのドキュメントを参照してください。


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

オンプレミスファイルコネクタのドキュメントを参照してください。


Last updated: 2024/2/13 16:59:53