1. Homepage
  2. Connector DevKit (3.9)
  3. Anypoint Connector プロジェクトの作成
  4. 認証のサポート

  5. OAuth V1

OAuth V1

DevKit は、Studio 6 および Mule 3 とのみ互換性があります。Mule 4 Connector を作成するには、 「Mule SDK」ドキュメント​を参照してください。

このページでは、DevKit による OAuth V1 認証のサポートについて詳しく説明し、API に対する認証に OAuth V1 を使用するコネクタを実装する方法について説明します。

前提条件

このドキュメントは、読者が ​Anypoint Connector DevKit​ に精通していて、コネクタに認証を実装する準備が整っていることを前提としています。読者がさまざまな​認証方法​に精通していて、API に対する認証に OAuth V1 を使用していることを前提としています。

OAuth V1 認証の概要や仕組みに精通していない場合、​ OAuth Core 1.0 ドキュメント​を参照することをお勧めします。

必要な API 情報

サービスプロバイダの API ドキュメントから、以下の表で示している変数の値を取得します。これらの変数は、認証プロセス中に使用する URL を参照します。このプロセスのステップについての詳細は、 「(OAuth 1.0a 仕様)」​の Authenticating With OAuth (OAuth を使用した認証) セクションを参照してください。

変数 説明

requestTokenUrl

要求トークンを取得するための URL

accessTokenUrl

アクセストークンを取得するための URL

authorizationUrl

リソースアクセスへの認証を取得するための URL

API へのアクセス権を調整する必要もあります。このプロセスは各 API プロバイダに固有ですが、このプロセスの一般的なステップについては​「API アクセスのセットアップ」​で説明しています。

@OAuth アノテーション

コネクタで OAuth V1 認証を実装するには、​@Connector​ クラスで ​@OAuth​ アノテーションを使用する必要があります。

ビルドプロセス中に、@OAuth アノテーションが付加されたコネクタは ​authorize​ および ​unauthorize​ という名前の自動生成された 2 つの @Processor メソッドを取得します。これらのメッセージプロセッサは、OAuth セッションの開始と終了を行います。

次の表で、​@OAuth​ アノテーションのパラメータについて説明します。

パラメータ 説明 必須かどうか デフォルト値

messageSigner​

OAuth 1.0a フローで使用する署名メソッド。
このメソッドは ​auth_signature_method​ パラメータに含まれます。

HMAC_SHA1​

signingStrategy

OAuth 1.0a パラメータが含まれる場所を定義します。

AUTHORIZATION_HEADER​

requestTokenUrl

未認証の要求トークンを取得するためにサービスプロバイダによって定義される URL。

✓

accessTokenUrl

アクセストークンを取得するためにサービスプロバイダによって定義される URL。

✓

authorizationUrl

サービスプロバイダによって定義される URL。リソースオーナーはコンシューマに認証を許可するためにこの URL にリダイレクトされます。

✓

verifierRegex

リソースオーナーがコンシューマを認証した後で、サービスプロバイダの応答からベリファイアを抽出するために使用される Java 正規表現。

oauth_verifier=([^&]+)​

callbackPath

サービスプロバイダが受け入れるのが既知のリダイレクト URL のみの場合、このパラメータを、リダイレクト URL としてサービスプロバイダに登録されるドメイン (​fullDomain​ 環境変数で示される) 内のパスに割り当てます。空のままにした場合 (つまり、サービスプロバイダがリダイレクト URL として任意の URL を受け入れる場合)、Mule はランダムなパスを使用します。

<random path>​

Maven プロジェクトの連動関係

DevKit を使用して OAuth 1.0 に対する認証を実装する場合、次の連動関係を Maven ​pom.xml​ ファイルに追加する必要があります。

<dependency>
   <groupId>oauth.signpost</groupId>
   <artifactId>signpost-core</artifactId>
   <version>1.2.1.1</version>
</dependency>

@Connector クラスでの @OAuth アノテーションの追加

OAuth V1 は他の認証方法と異なり接続戦略として実装することはできず、​@Connector​ クラスレベルでのアノテーションのみ使用できます。 
@Connector(name = "myconnector", friendlyName = "MyConnector")
@OAuth(requestTokenUrl = "https://api.mycommector.com/uas/oauth/requestToken",
accessTokenUrl = "https://api.mycommector.com/uas/oauth/accessToken",
authorizationUrl = "https://api.mycommector.com/uas/oauth/authorize")
public class MyConnector {
    /**
    * YOUR CODE GOES HERE
    */
}

@Connector クラスのプロパティ

ユーザがコネクタを使用するときにコンシューマキーおよびシークレットを指定できるようにするには、​@Connector​ クラスで OAuth に関連した ​@Configurable​ インスタンスプロパティが必要です。

  • OAuth コンシューマキーを保持するための ​@OAuthConsumerKey​

  • OAuth コンシューマシークレットを保持するための ​@OAuthConsumerSecret

@Configurable @OAuthConsumerKey private String consumerKey;
@Configurable @OAuthConsumerSecret private String consumerSecret;

また、アクセストークンおよびアクセストークンシークレットを保持するための String (文字列) プロパティも必要であり、以下で示しているように public getter および setter (非表示) のアノテーションが付加されます。

@OAuthAccessToken private String accessToken;
@OAuthAccessTokenSecret private String accessTokenSecret;

@Processor メソッドのアノテーション

@Processor​ メソッドを保護するために、次に示しているように @OAuthProtected アノテーションを付加します。

@OAuthProtected
@Processor
    public void logInfo() {
        logger.info(String.format("OAuthAccessToken=%s", getAccessToken()));
        logger.info(String.format("OAuthAccessTokenSecret=%s", getAccessTokenSecret()));
    }

@OAuthProtected
@Processor
public void myOperation(String source, Object destination)
{
    /**
    * CODE FOR MYOPERATION
    */
}

@OAuthProtected @Processor​ メソッドが呼び出されると、次のアクティビティを開始します。

  1. 保護されたリソースに初めてアクセスするときに、ユーザは保護されたリソースへのコンシューマのアクセス権を許可または拒否するためにサービスプロバイダの認証 URL にリダイレクトされます。

  2. 以降のアクセス要求中に、Mule は​アクセストークン​および​アクセストークンシークレット​ (​@OAuthAccessToken​ および ​@OAuthAccessTokenSecret​ のアノテーションが付いたパラメータ内に含まれる) をサービスプロバイダへの要求に含めます。詳細は、 OAuth 1.0a specification (OAuth 1.0a 仕様)​ を参照してください。

クライアントクラスに OAuth ヘッダーを含める

ほとんどの OAuth 1.0 実装では Jersey クライアントを使用して RESTful API にアクセスしますが、一部の実装ではアプリケーションに固有の Java クライアントライブラリを使用します。ただし、どのクライアントを使用する場合でも、要求と一緒にコンシューマキー、コンシューマシークレット、アクセストークン、アクセストークンシークレットを送信するには、クライアントクラスレベルでコードを追加します。

Jersey クライアントのサンプルでは、この追加は次に示しているように、クライアントクラスのヘルパーメソッド ​addSignHeader()​ によって実行されます。

private WebResource addSignHeader(WebResource webResource) {
  OAuthParameters params = new OAuthParameters();
  params.signatureMethod("PLAINTEXT");
  params.consumerKey(getConnector().getConsumerKey());
  params.setToken(getConnector().getAccessToken());

  OAuthSecrets secrets = new OAuthSecrets();
  secrets.consumerSecret(getConnector().getConsumerSecret());
  secrets.setTokenSecret(getConnector().getAccessTokenSecret());
  OAuthClientFilter filter = new OAuthClientFilter(client.getProviders(), params, secrets);

  webResource.addFilter(filter);
  return webResource;
}

コネクタはこのメソッドを通じて Dropbox API にすべてのコールを渡し、OAuth V1 標準によって指定された認証ヘッダーを追加します。これは Jersey クライアントを使用する場合に限られるため、このメソッドの詳細な手順およびクライアントクラスへの適合についてはここでは説明しません。詳細については、​Jersey を使用した RESTful API 用のコネクタの作成​についての説明を参照してください。

OAuth V1 Connector の使用

コネクタをビルドしてインストールしたら、以降のセクションで説明しているように、フローで使用できます。

コネクタの認証

リソースオーナーが保護されたリソースへのアクセス権をコネクタに付与しないと、コンシューマは認証を必要とする操作を実行できません。認証要求を受信すると、Mule はリソースオーナーのブラウザをサービスプロバイダの認証ページにリダイレクトします。それ以降、保護されたリソースにアクセスしようとすると、​@OAuthAccessToken​ および ​@OAuthAccessTokenSecret​ のアノテーションが付加されたパラメータが入力されます。Mule はアクセストークンおよびトークンシークレットをサービスプロバイダへの要求に含めます。下の例では、​ LinkedIn Connector​ を使用しています。

<linkedin:config apiKey="${api.key}" apiSecret="${api.secret}"/>
...
  <flow name="authorize">
      <http:inbound-endpoint host="localhost" port="8080" path="/authorize"/>
      <linkedin:authorize/>
  </flow>

フローでのコネクタの設定

  1. サービスプロバイダから指定されたようにアプリケーションの​コンシューマキー​および​コンシューマシークレット​を渡して、拡張機能を設定します。下のコードサンプルは、こうした設定の例を示しています。

    <linkedin:config apiKey="${api.key}" apiSecret="${api.secret}"/>
...
  <flow name="sampleFlow">
      <linkedin:get-profile-for-current-user />
  </flow>

  2. 保護されたリソースへのアクセスを試みるシンプルなフローを設定します。コネクタが OAuth によって認証されていない場合、コンシューマの操作で ​NotAuthorizedException​ がスローされます。

コールバックのカスタマイズ

ユーザが保護されたリソースへのアクセス権を付与した場合、サービスプロバイダは HTTP コールバックを行います。このコールバックでは、認証コードが渡されます。Mule は後でこれを使用してアクセストークンを取得します。コールバックを処理するために、Mule は動的に HTTP インバウンドエンドポイントを作成し、続いてエンドポイントの URL をサービスプロバイダに渡します。そのため、HTTP コールバックを行うために特定の設定を行う必要はありません。

デフォルトでは、Mule はホストおよびポート (​fullDomain​ 環境変数および ​http.port​ によって決定される) を使用してサービスプロバイダに送信する URL を構築します。ホストおよびポートにデフォルト以外の値を使用する必要がある場合は、下のコード例で示しているように、設定を追加します。

<linkedin:config apiKey="${api.key}" apiSecret="${api.secret}">
<linkedin:oauth-callback-config domain="SOME_DOMAIN" remotePort="SOME_PORT"/>
</linkedin:config>

Mule によるコールバックの処理についての詳細は、HTTP コールバックについての説明を参照してください。

Secure Socket Layer (SSL) の追加

Mule が OAuth コールバックを処理するために HTTP インバウンドエンドポイントを自動的に起動する場合、デフォルトでは HTTP Connector を使用します。サービスプロバイダが ​HTTPS​ を必要とする場合、独自の HTTPS Connector を渡すように Mule を設定できます。

NOTE: HTTPS Connector​ の設定についての詳細は、​「HTTPS トランスポートリファレンス」​および ​HTTPS の例​を参照してください。

関連情報

コネクタ機能の追加