REST 呼び出しおよび SOAP 呼び出しの認証

SAML ユーザー

SAML ログイン資格情報は、意思決定サービスへの認証には使用できません。 SAML を使用してクラウド・ポータルにログインする場合は、REST 呼び出しまたは SOAP 呼び出しのサービス資格情報を要求する必要があります。 IBM® の内部ユーザーは、自動的に SAML を使用してポータルにログインするため、サービス資格情報を要求する必要があります。

サービス資格情報の呼び出し

以下のステップでは、別個のファイルからサービス資格情報を呼び出すようにアプリケーションをセットアップする方法を示しています。 お客様の IT ストラテジーによっては、サービス資格情報の代わりに、ローカル・アカウントの資格情報を使用することもできます。

1. クラウド管理者からサービス資格情報を入手します。 サービス資格情報を生成できるのは、クラウド管理者のみです。 サービス資格情報には、機能 ID とパスワードが含まれています。
2. サービス資格情報をプロパティー・ファイル (sc.properties など) に配置します。

   odmoc.url=https://mytenant.bpm.ibmcloud.com/odm/dev
   odmoc.functionalId=api1.fid@t1023
   odmoc.password=xfmptNJsQONCvRXB1bYS1AxlIcYyh1UR2y/LMpyx

   この例のプロパティーは、次のように定義されています。

   プロパティー	説明
   odmoc.url	クラウド・ポータルのテナントの URL
   odmoc.functionalId	サービス資格情報の機能 ID
   odmoc.password	サービス資格情報のパスワード

3. アプリケーションで、ファイル sc.properties からサービス資格情報を呼び出すコードを追加します。 以下のコードは、Java™ クライアントからのものです。

   package test;
   
   import java.io.FileInputStream;
   import java.io.FileNotFoundException;
   import java.util.Properties;
   
   import org.apache.commons.codec.binary.Base64;
   import org.apache.http.HttpResponse;
   import org.apache.http.Header;
   import org.apache.http.client.HttpClient;
   import org.apache.http.client.methods.HttpGet;
   import org.apache.http.conn.ssl.NoopHostnameVerifier;
   import org.apache.http.conn.ssl.TrustSelfSignedStrategy;
   import org.apache.http.impl.client.HttpClientBuilder;
   import org.apache.http.impl.client.HttpClients;
   import org.apache.http.ssl.SSLContextBuilder;
   import org.apache.http.util.EntityUtils;
   
   import com.ibm.json.java.JSONObject;
   
   public class OdmRestClient {
       
       public static void main(String[] args) throws Exception {
   	// The builder should be configured to connect using HTTPS to ODM on Cloud,
   	// and must use a secure cipher with hostname verification. The following
   	// code does not reflect all the required settings.
           HttpClientBuilder builder = HttpClients.custom();
           builder.disableRedirectHandling();
           HttpClient client = builder.build();
   
           // This code calls the service credentials from the file sc.properties. 
           //It reads the url, functional Id and password from a property file.
           String configFile = "sc.properties";
           FileInputStream fistream = null;
           try {
               fistream = new FileInputStream(configFile);
           }
           catch (FileNotFoundException e) {
               System.out.println("Could not open file: " + configFile);
               System.exit(0);
           }
           Properties props = new Properties();
           props.load(fistream);
   
   	String baseurl = props.getProperty("odmoc.url");
           String fid = props.getProperty("odmoc.functionalId");
           String pwd = props.getProperty("odmoc.password");
   	String url = baseurl + "/res/api/v1/ruleapps?count=true";
   	
           // Basic Authentication header value
           String baHeader = fid + ":" + pwd;
   	System.out.println("BA header is: " + baHeader);
           baHeader = Base64.encodeBase64String(baHeader.getBytes());
           
           // execute request
           HttpResponse response = null;
   	System.out.println("** Calling: " + url);
   
           HttpGet request = new HttpGet(url);
           request.setHeader("Authorization", "Basic " + baHeader);                        
           try {
              response = client.execute(request);
           }
           catch (Exception e) {
              throw new Exception("Could not execute API call, reason: " + e.getMessage());
           }
           
           int httpRespCode = response.getStatusLine().getStatusCode();
   	System.out.println("Response code is: " + httpRespCode);
   
           if (httpRespCode==302) {
               // We are in one of these 3 cases: wrong ID, wrong password, account locked
               System.out.println("Basic auth access denied.");
   	    System.out.println("Reason1: Wrong ID or password");
   	    System.out.println("Reason2: Account locked after some unsuccessful attempts");
           }                        
           else if (httpRespCode==401) {
   	    // Aithorization is not granted to access the URL
               System.out.println("ODM API access was denied: you are not authorized");
           }
           else if (httpRespCode==200){                    
   	    // Correct execution result, extract the HTTP response
               String json = EntityUtils.toString(response.getEntity(), "UTF-8");
               System.out.println("Successful invocation, result : " + json);
           }
   	else {
   	    // Diagnose why such a code. Contact IBM support with all the details.
   	    System.out.println("Unexpected return code: " + httpRespCode);
   	}
       }
   }

HTTP クライアント・サイドは、認証中に以下のコードを戻す可能性があります。