パート5：オプションと詳細設定

新しいインストーラ（バージョン10.1.1.102.0以降で使用可能）を使用していない場合は、タイムアウト値を設定する前にアプリケーションをインストールする必要があります。

1. リリースフォルダ内のICM-cli.exeインストールファイルをダブルクリックします。

2. インストールウィザードの手順を完了します。

IBM Cognos ICM CLI.exe.configファイルを開き、タイムアウト値を大きな値に設定します。

たとえば、タイムアウト値を90000000に設定します。

ファイルを保存します。

OPENSSLをインストールします。

次のような新しいディレクトリをコンピュータ上に作成します。C:/Users/Administrator/Desktop/SSOCerKey

コマンドプロンプトを開き、次のコマンドを実行します。

openssl.exe req -x509 -newkey rsa:2048 -keyout
C:/Users/Administrator/Desktop/SSOCerKey/key.pem -out 
C:/Users/Administrator/Desktop/SSOCerKey/cert.pem -days 365

同じコマンドラインウィンドウで、カレントディレクトリを、key.pemおよびcert.pemファイルが生成された場所に変更します。

次のコマンドを実行して、key.pemファイルを復号化します。

openssl rsa -in C:/Users/Administrator/Desktop/SSOCerKey/key.pem –out C:/Users/Administrator/Desktop/SSOCerKey/keyDecrypted.pem

cert.pemファイルをコピーして貼り付け、名前をcert.cerに変更します。

これにより、ブラウザでファイルを開き、証明書の有効期限を確認できます。この日付は後で必要になりますので、メモしてください。

テキストエディタを使用して、復号化されたキーファイルのkeyDecrypted.pemを開きます。

SAML 2.0 IdPにアップロードするメタデータを取得するには、次のREST API呼び出しを実行します。

GET yourServer/services/ssoAdminweb/configs/1/metadata 

このコマンドの戻り値をsp.xmlとして保存します。XMLファイルとして保存するには、コピーしてテキストエディタに貼り付けます。

IdPにsp.xmlファイルをアップロードします。

Apache HTTPサーバーのインストールディレクトリに移動し、confフォルダを開きます。

例： C:\Program Files (x86)\Apache Software Foundation\Apache2.2\conf

テキストエディタを使用してhttpd.confファイルを開きます。

行の先頭にある番号記号（#）を削除して、次の行のコメントを解除します。

完了すると、行は次のようになります。

LoadModule proxy_module modules/mod_proxy.so 
LoadModule proxy_connect_module modules/mod_proxy_connect.so 
LoadModule proxy_http_module modules/mod_proxy_http.so

httpd.configファイルに次の行を追加し、設定に応じて行を変更します。

<VirtualHost *:443>
     ServerAdmin “serveradmin“
     DocumentRoot "{ApacheInstallDirectory}\Apache2.4\htdocs"
     ServerName   “severname“
     ErrorLog "{ApacheInstallDirectory}\Apache2.4\error.log"
     CustomLog "{ApacheInstallDirectory}\Apache2.4\access_log.log" hgvhostAccesslog
	 ProxyPass /services /{{your tenant service domain}}:{{Ts domain port}}/services
	 ProxyPassReverse /services /{{your tenant service domain}}:{{Ts domain port}}/services
</VirtualHost>

Apacheサーバー、テナントサービス（node.js）、およびREST APIを再起動します。

管理者Webアプリケーションにアクセスします。

ユーザーIDを入力し、[送信]をクリックします。

IdPログインページにリダイレクトされます。

IdPでログインします。認証が完了すると、管理者Webアプリケーションにリダイレクトされます。

SAML 2.0 IdPにアップロードするメタデータを取得するには、次のREST API呼び出しを実行します。

GET yourServer/services/ssoAdminweb/configs/1/metadata 

このコマンドの戻り値をsp.xmlとして保存します。XMLファイルとして保存するには、コピーしてテキストエディタに貼り付けます。

IdPにsp.xmlファイルをアップロードします。

Apache HTTPサーバーのインストールディレクトリに移動し、confフォルダを開きます。

例： C:\Program Files (x86)\Apache Software Foundation\Apache2.2\conf

テキストエディタを使用してhttpd.confファイルを開きます。

行の先頭にある番号記号（#）を削除して、次の行のコメントを解除します。

完了すると、行は次のようになります。

LoadModule proxy_module modules/mod_proxy.so 
LoadModule proxy_connect_module modules/mod_proxy_connect.so 
LoadModule proxy_http_module modules/mod_proxy_http.so

httpd.configファイルに次の行を追加し、設定に応じて行を変更します。

<VirtualHost *:443>
     ServerAdmin “serveradmin“
     DocumentRoot "{ApacheInstallDirectory}\Apache2.4\htdocs"
     ServerName   “severname“
     ErrorLog "{ApacheInstallDirectory}\Apache2.4\error.log"
     CustomLog "{ApacheInstallDirectory}\Apache2.4\access_log.log" hgvhostAccesslog
	 ProxyPass /services /{{your tenant service domain}}:{{Ts domain port}}/services
	 ProxyPassReverse /services /{{your tenant service domain}}:{{Ts domain port}}/services
</VirtualHost>

Apacheサーバー、テナントサービス（node.js）、およびREST APIを再起動します。

管理者Webアプリケーションにアクセスします。

ユーザーIDを入力し、[送信]をクリックします。

IdPログインページにリダイレクトされます。

IdPでログインします。認証が完了すると、管理者Webアプリケーションにリダイレクトされます。

Salesforceにログインします。

ユーザー名をクリックし、[設定]をクリックします。

サイドバーの[開発]セクションで、[Visualforceページ]をクリックします。

[新規]をクリックします。

ラベルとページ名を入力します。

[Lightning Experience、Lightning Communities、およびモバイルアプリで使用可能]チェックボックスを選択します。

[Visualforceマークアップ]セクションで、デフォルトのコードを次のコードに置き換えます。

<apex:page showHeader="false" standardStylesheets="false" sidebar="false" applyHtmlTag="false" applyBodyTag="false" docType="html-5.0" >    
    <apex:pageblock >        
        <apex:iframe src="https://rti.spm.varicent.com/payeeweb/sforce_composite_login?SessionId={!$Api.Session_ID}&ServerURL={!$Api.Partner_Server_URL_210}&Tenant=rti&Model=rtiprod" scrolling="true" id="theIframe" style='position:absolute; top:0px; left:0px; width:100%; height:100%; z-index:999'/>    
    </apex:pageblock>
</apex:page>                                       

[保存]をクリックします。

Payee Web ClassicのWebフォームタブの場合、このコード「&nextPath=webforms/index.html?tabId=#」を、リンクするWebフォームのタブIDを「#」に置き換えて追加します。

例として、コードは次のようになります。

<apex:page showHeader="false" standardStylesheets="false" sidebar="false" applyHtmlTag="false" applyBodyTag="false" docType="html-5.0" >    
    <apex:pageblock >        
        <apex:iframe src="https://rti.spm.varicent.com/payeewebv2/sforce_composite_login?SessionId={!$Api.Session_ID}&ServerURL={!$Api.Partner_Server_URL_210}&Tenant=rti&Model=rtiprod&nextPath=webforms/index.html?tabId=1" scrolling="true" id="theIframe" style='position:absolute; top:0px; left:0px; width:100%; height:100%; z-index:999'/>    
    </apex:pageblock>
</apex:page>

Payee Web Classicの[プレゼンター・レポート]タブの場合、[Visualforce]ページの作成のステップ7で、次のコードをModel名の後に追加します：&nextPath=reporting/index.html?tabId=1

例として、コードは次のようになります。

<apex:page showHeader="false" standardStylesheets="false" sidebar="false" applyHtmlTag="false" applyBodyTag="false" docType="html-5.0" >    
    <apex:pageblock >        
        <apex:iframe src="https://rti.spm.varicent.com/payeewebv2/sforce_composite_login?SessionId={!$Api.Session_ID}&ServerURL=https%4B%3H%3Hd.na15.visual.force.com%3Hservices%3HSoap%3Hv%3H21.1%3H00EB000000018FJ&Tenant=rti&Model=rtiprod&nextPath=reporting/index.html?tabId=1" scrolling="true" id="theIframe" style='position:absolute; top:0px; left:0px; width:100%; height:100%; z-index:999' />    
    </apex:pageblock>
</apex:page>

Sales PortalのWebフォームタブの場合、[Visualforce]ページの作成のステップ7で、###をリンクするタブの番号に置き換えて、Model名の後に次のコードを追加します：nextPathname=WebForm/###

例として、コードは次のようになります。

<apex:page showHeader="false" standardStylesheets="false" sidebar="false" applyHtmlTag="false" applyBodyTag="false" docType="html-5.0" >    
    <apex:pageblock >        
        <apex:iframe src="https://rti.spm.varicent.com/payeewebv2/sforce_composite_login?SessionId={!$Api.Session_ID}&ServerURL={!$Api.Partner_Server_URL_210}&Tenant=rti&Model=rtiprod&nextPathname=WebForm/492" scrolling="true" id="theIframe" style='position:absolute; top:0px; left:0px; width:100%; height:100%; z-index:999'/>    
    </apex:pageblock>
</apex:page>

Sales Portalの[プレゼンター・レポート]タブの場合、リンクするタブの数を「###」に置き換えて、このコード「nextPathname=PresenterReport/###」を追加します。

例として、コードは次のようになります。

<apex:page showHeader="false" standardStylesheets="false" sidebar="false" applyHtmlTag="false" applyBodyTag="false" docType="html-5.0" >    
    <apex:pageblock >        
        <apex:iframe src="https://rti.spm.varicent.com/payeewebv2/sforce_composite_login?SessionId={!$Api.Session_ID}&ServerURL={!$Api.Partner_Server_URL_210}https%4B%3H%3Hd.na15.visual.force.com%3Hservices%3HSoap%3Hv%3H21.1%3H00EB000000018FJ&Tenant=rti&Model=rtiprod&nextPathname=PresenterReport/683" scrolling="true" id="theIframe" style='position:absolute; top:0px; left:0px; width:100%; height:100%; z-index:999'/>    
    </apex:pageblock>
</apex:page>

Sales Portalにおいて、Data Discovery DashboardsおよびData Discovery InfographicsWebタブの場合、リンクするタブの数を「###」に置き換えて、このコード「nextPathname=DDE/###」を追加します。

例として、コードは次のようになります。

<apex:page showHeader="false" standardStylesheets="false" sidebar="false" applyHtmlTag="false" applyBodyTag="false" docType="html-5.0" >    
    <apex:pageblock >        
        <apex:iframe src="https://rti.spm.varicent.com/payeewebv2/sforce_composite_login?SessionId={!$Api.Session_ID}&ServerURL={!$Api.Partner_Server_URL_210}&Tenant=rti&Model=rtiprod&nextPathname=DDE/456" scrolling="true" id="theIframe" style='position:absolute; top:0px; left:0px; width:100%; height:100%; z-index:999'/>    
    </apex:pageblock>
</apex:page>

Sales Portalにおいて、Rapid ReportsWebタブの場合は、リンクするタブの数を「###」に置き換えて、このコード「nextPathname=RapidReport/###」を追加します。

例として、コードは次のようになります。

<apex:page showHeader="false" standardStylesheets="false" sidebar="false" applyHtmlTag="false" applyBodyTag="false" docType="html-5.0" >    
    <apex:pageblock >        
        <apex:iframe src="https://rti.spm.varicent.com/payeewebv2/sforce_composite_login?SessionId={!$Api.Session_ID}&ServerURL={!$Api.Partner_Server_URL_210}&Tenant=rti&Model=rtiprod&nextPathname=RapidReport/123" scrolling="true" id="theIframe" style='position:absolute; top:0px; left:0px; width:100%; height:100%; z-index:999'/>    
    </apex:pageblock>
</apex:page>

Sales Portalの[ダイレクトリンク]Webタブ（プレゼンター・レポート、Rapid Reports、Data Discovery Dashboards）の場合、リンクするタブの数を入れてこのコード「nextPathname=DirectLink/###」を追加します。

例として、コードは次のようになります。

<apex:page showHeader="false" standardStylesheets="false" sidebar="false" applyHtmlTag="false" applyBodyTag="false" docType="html-5.0" >    
    <apex:pageblock >        
        <apex:iframe src="https://rti.spm.varicent.com/payeewebv2/sforce_composite_login?SessionId={!$Api.Session_ID}&ServerURL={!$Api.Partner_Server_URL_210}&Tenant=rti&Model=rtiprod&nextPathname=DirectLink/416" scrolling="true" id="theIframe" style='position:absolute; top:0px; left:0px; width:100%; height:100%; z-index:999'/>    
    </apex:pageblock>
</apex:page>

ポータル・アクセスの[Webタブ]タブで、[Webタブの追加]アイコンをクリックします。

[名前]フィールドに、Webタブの名前を入力します。ハイフンやアポストロフィなどの特殊文字を使用できます。

[タイプ]メニューから[ダイレクトリンク]を選択します。

[ダイレクトリンクタイプ]メニューから、[データ・ディスカバリ・ダッシュボード]または[インフォグラフィック]、[プレゼンター・レポート]、または[ラピッド・レポート]を選択します。

[オブジェクト]ドロップダウン・リストから、Webタブに割り当てるオブジェクトを選択します。

[Webタブの追加]をクリックします。

作成したWebタブの行にマウスオーバーし、[URLをコピー]ボタンをクリックします。

URLをテキストエディタに貼り付け、ID番号をコピーします。

たとえば、URLがhttp://rti.spm.varicent.com/payeewebv2/DirectLink/4096の場合、SalesforceでURLをコピー4096してコードに追加する必要があります。

ユーザー名をクリックし、[設定]をクリックします。

サイドバーから[タブ → を作成]に移動します。

[Visualforceタブ]セクションで、[新規]をクリックします。

ラベルとタブ名を入力します。

作成したVisualForceページを選択します。

希望するタブスタイルを選択します。

アクセスを許可するプロファイルに基づいて、タブの可視性を追加します。

[保存]をクリックします。

[検索]を使用して「Salesforceナビゲーション」を検索し、[Salesforce管理]メニューから選択します。

作成したタブを見つけ、それを[使用可能]から[保存]に移動します。

[保存]をクリックします。

モバイルデバイスで、iOSアプリストアまたはGooglePlayストアからSalesforceアプリをダウンロードします。

Salesforceアプリにログインします。

メニューから、追加したVisualForceタブの名前を見つけます。

defaults.jsonで、ポートとプロトコルが正しいApache TomcatサーバーのHTTPSおよびSSL設定に追加されるよう、Payeewebセクションを編集します。

次のようになります。

"Payeeweb" : 
    {            
        "port": 8443,
        "protocol": "https",
    }

Apache 2.4 htdocsをインストールした場所に移動し、index.htmlを開きます。API_URLとAUTH_URLを編集して、 defaults.jsonとREST API.exe.configのホスト値と一致させます。

次のようになります。

API_URL: 'http://yourServer.varicent.com:8080',
AUTH_URL: 'http://yourServer.varicent.com:9100',

Apache Webサーバーをまだインストールしていない場合は、Apache Web Serverのインストールの手順に従います。

1. C:\Program Files\Apache Software Foundation\Apache2.2.16\confに移動します。

2. httpd.confファイルを開き、番号記号（#）を使用して<Directory />セクションをコメントアウトします。

3. <Directory "C:/Program Files/Apache Software Foundation/Apache2.2.16/htdocs">と</Directory>タグの間に、次の行を追加します。

   DirectoryIndex index.html
   FallbackResource /index.html

httpd.confファイルの中の次の行から、番号記号（#）を削除します。

LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
LoadModule ssl_module modules/mod_ssl.so

これらのセクションをhttpd.confに追加します。

Listen 433
<VirtualHost *:433>       
    ServerName yourServer       
    SSLEngine on       
    SSLCertificateKeyFile C:/Users/user/Desktop/device.key       
    SSLCertificateFile C:/Users/user/Desktop/device.crt       
    SSLProtocol -all +TLSv1.2       
    SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-RSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA:DHE-RSA-AES256-SHA256:DHE-RSA-AES256-SHA:!DSS       
    ProxyPass /services/ http://yourServer:9100/services       
    ProxyPassReverse /services/ http://yourServer:9100/services
    ProxyPass /api/ http://localhost:8080/api/
    ProxyPassReverse /api/ http://localhost:8080/api/
</VirtualHost> 

Listen 9001
<VirtualHost *:9001>       
    ServerName yourServer       
    SSLEngine on       
    SSLCertificateKeyFile C:/Users/user/Desktop/device.key       
    SSLCertificateFile C:/Users/user/Desktop/device.crt       
    SSLProtocol -all +TLSv1.2       
    SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-RSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA:DHE-RSA-AES256-SHA256:DHE-RSA-AES256-SHA:!DSS       
    ProxyPass /services/ http://yourServer:9101/services       
    ProxyPassReverse /services/ http://yourServer:9101/services
    ProxyPass /api/ http://localhost:8080/api/
    ProxyPassReverse /api/ http://localhost:8080/api/
</VirtualHost>

1. SSLCertificateKeyFileとSSLCertificateFileをファイルの場所で更新します。

2. ProxyPassとProxyPassReverseをサーバーのホスト名とIPで更新します。

デフォルトのApache証明書.crtと.keyファイルを、独自の信頼できる証明書に置き換えます。

デフォルトでは、これらのファイルはC:\Program Files\Apache24\conf\ssl\server.crtとC:\Program Files\Apache24\conf\ssl\server.keyにあります。

Tomcat /payeeweb/WEB-INF/security.propertiesファイルのこれらのフィールドを更新します。Apache HTTPサーバーの仮想ホスト値と一致する必要があります。また、プロトコルはhttpsの代わりにhttpに変更する必要があります。

C:\Program Files\Apache Software Foundation\Tomcat\7.0\webapps\payeeweb\WEB-INF\security.properties 

# JWT Configuration
security.jwt.home=/home.html
security.jwt.tenant-services-url=https://yourServer:433/services/varicent_web_login
security.jwt.secretkey=varicent-ca-varicent-varicentweb-secret-key
security.jwt.tenantServicesPrivateUrl=https://yourServer:9001/services
security.jwt.tenantSecretKey=varicent-tenant-varicent-spm-production

Apache Tomcatガイドに従って、TomcatでSSLを設定します。

server.xmlファイルにアクセスすると、完了すると次のようになり、ポート8443のコネクタがkeystoreFileを使用するよう設定されます。

<Connector port="8085" protocol="HTTP/1.1"
    connectionTimeout="20000"
    redirectPort="8443" />                                

<Connector port="8443" 
protocol="org.apache.coyote.http11.Http11Protocol" SSLEnabled="true"
maxThreads="150" scheme="https" secure="true"
clientAuth="false" sslProtocol="TLS" keyAlias="ICMSSL"     keystoreFile="C:/keystore_Tomcat_SSL.jks" keystorePass="test" />

Javaの信頼されたキーストア証明書を使用するすべてのApache HTTPとApache Tomcat証明書を追加します。

詳細については、IBM SDK, Java Technology Edition 7.1 cacerts証明書ファイルを参照してください。

コマンドラインから、Javaのbinフォルダをインストールした場所に移動します。

keytoolを使用して、Apache HTTP とApache Tomcat Webサーバーで使用されるすべての証明書を Javaキーストア（cacerts）にインポートして、すべての証明書を信頼できるようにします。

1つの証明書のみを使用している場合は、メインの証明書とルート証明書をインポートする必要があります。Tomcat SSLが異なる証明書を使用する場合、それもインポートする必要があります。次の例は、メインの証明書、ルート証明書、Tomcat SSL証明書のインポートを示しています。

C:\Program Files\Java\jre1.8.0_144\bin>keytool.exe -import -keystore "C:\Program Files\Java\jre1.8.0_144\lib\security\cacerts" -alias yourServer.varicent.com.device -file C:\Users\ user \Desktop\currentCerts\device.crt
Enter keystore password: changeit
Certificate was added to keystore

C:\Program Files\Java\jre1.8.0_144\bin>keytool.exe -import -keystore "C:\Program Files\Java\jre1.8.0_144\lib\security\cacerts" -alias yourServer.varicent.com.rootCa -file C:\Users\ user \Desktop\currentCerts\rootCA.pem
Enter keystore password: changeit 
Certificate was added to keystore

C:\Program Files\Java\jre1.8.0_144\bin>keytool.exe -import -keystore "C:\Program Files\Java\jre1.8.0_144\lib\security\cacerts" -alias yourServer.varicent.com.TomcatSSL -file C:\Users\user\Desktop\currentCerts\yourTomcatSSLcertificate.cer
Enter keystore password: changeit
Certificate was added to keystore

Apache HTTPサーバーとApache Tomcatサービスを再起動します。

テキストエディタを使用して、ファイルを作成し、v3.extと名前を付けます。

このコンテンツをファイルに追加し、serverとaltの名前をサーバー情報に置き換えます。

authorityKeyIdentifier=keyid,issuer
basicConstraints=CA:FALSE
keyUsage = digitalSignature, nonRepudiation, keyEncipherment,                 dataEncipherment
subjectAltName = @alt_names

[alt_names]
DNS.1 = localhost
DNS.2 = yourServer
DNS.3 = *.yourDomain
IP.1 = 127.0.0.1
IP.2 = 1.2.3.4

コマンドラインから、OpenSSLのbinフォルダをインストールした場所に移動します。

デフォルトでは、次の場所にインストールされます：C:\OpenSSL-Win32\bin

次のコマンドを実行して、出力ファイルを生成します。

openssl genrsa -out rootCA.key 2048

openssl req -x509 -new -nodes -key rootCA.key -sha256 -days 1024 -out rootCA.pem

openssl req -new -newkey rsa:2048 -sha256 -nodes -keyout device.key -subj "/C=CA/ST=None/L=NB/O=None/CN=yourServer.varicent.com" -out device.csr

openssl x509 -req -in device.csr -CA rootCA.pem -CAkey rootCA.key -CAcreateserial -out device.crt -days 999 -sha256 -extfile v3.ext

成功した場合、次のファイルが出力されます：rootCA.key、rootCA.pem、device.key、device.csr、device.crt。

Microsoft MMCを使用して、これらの証明書を信頼できるルート証明書としてインストールします。

この方法の詳細は、Microsoftのドキュメントを参照してください。

コマンドラインから、OpenSSLのbinフォルダをインストールした場所に移動します。

デフォルトでは、C:\OpenSSL-Win32\binにインストールされます。

このコマンドを実行して、既存の証明書と対応する秘密キーをPKCS12ファイルに変換します。

openssl.exe pkcs12 -export -in device.crt -inkey device.key -out keystore.p12 -name yourOrganization -chain

Javaのbinフォルダをインストールした場所に移動します。

PKCSファイルに基づいてキーストアを作成するには、次のコマンドを実行します。

"C:\Program Files\Java\jre1.8.0_144\bin\keytool.exe" -importkeystore -deststorepass changeit -destkeypass changeit -destkeystore keystoreConverted.jks -srckeystore keystore.p12 -srcstoretype PKCS12 -srcstorepass changeit -alias varicentCloud