Scripted BrowserでBasic認証を必要とする場合のTips

Published 2024년 4월 23일 6분 소요

Syntheticを使ってWebサイトのテストを行う場合、アクセス先のサイトにBasic認証を要する場合があります。

Basic認証の認証情報はURLにいれることができるので、ドキュメントでは、「https://username:password@site.com」のようにURLに認証情報をいれる方法が紹介されています。

Syntheticテストで最初にアクセスするページからBasic認証が必要な場合は、上記で特に問題ないのですが、途中から必要とする場合が少し面倒です。

この途中から行われる場合に、より容易に対応する方法を２つ紹介します。

なお、今回スクリプトの実証には、こちらのサイトを利用します。サイトのトップページアクセスへは認証情報は必要ありませんが、「Basic HTTP/NTLM Authentication」のタイルにある、「HTTP/NTLM Auth」のリンクをクリックすると、Basic認証が必要なページにアクセスするようになっています。

方法１：Authenticationヘッダーを利用する方法

Basic認証ではAuthenticationヘッダーで認証情報を渡すこともできます。例えば、認証情報が、ユーザ名：user、パスワード：passの場合、「user:pass」の文字列を base64エンコードした値「dXNlcjpwYXNzCg==」を利用し、以下のように追加することでヘッダーに付与することで対応ができます。

$headers.add('Authorization', 'Basic dXNlcjpwYXNzCg==');

スクリプト全体としては、以下のようになります。

var assert = require('assert');

//Basic認証用のヘッダを追加
$headers.add('Authorization', 'Basic dXNlcjpwYXNzCg==');

//以降にテストを記載
$browser.get('https://authenticationtest.com/').then(function() {
  //「HTTP/NTLM Auth」でリンクを探し、クリックする
  return $browser.findElement($driver.By.linkText("HTTP/NTLM Auth")).click().then(function() {

    // xpathでh1要素を探す
    return $browser.findElement($driver.By.xpath("/html/body/div/h1")).then(function(element) {
      //テキストの内容が「Login Success」であれば、成功にする
      return element.getText().then(function(text) {
        assert.equal('Login Success', text, 'H1 title did not match');
      }); 
    });
  });
});

「HTTP/NTLM Auth」のリンクをクリックした先のページではBasic認証が必要ですが、上記ヘッダの追加のみで、Basic認証が通り、テストが成功することが確認いただけます。

方法２：Chromeのキャッシュを利用する方法

SyntheticのScripted browserは、ChromeのRuntimeが動作しています。また、Chromeでは、Basic認証の認証情報がキャッシュされ、2回目以降はそのキャッシュが利用されることを活用します。

では、実際のスクリプトを見てみましょう。

var assert = require('assert');

//まず、Basic認証が必要な任意のページにアクセスし、認証情報をブラウザに記憶させる
$browser.get('https://user:pass@authenticationtest.com/HTTPAuth/').then(function(){

  //続いて、本来テストを行いたい最初にアクセスするページへアクセスする
  return $browser.get('https://authenticationtest.com/').then(function() {
	//「HTTP/NTLM Auth」でリンクを探し、クリックする
    return $browser.findElement($driver.By.linkText("HTTP/NTLM Auth")).click().then(function() {

      // xpathでh1要素を探す
      return $browser.findElement($driver.By.xpath("/html/body/div/h1")).then(function(element) {
        //テキストの内容が「Login Success」であれば、成功にする
        return element.getText().then(function(text) {
          assert.equal('Login Success', text, 'H1 title did not match');
        }); 
      });
    });
  });
});

スクリプトは非常に簡単で、以下のようになっています。

Basic認証が必要なページへ直接アクセスして、認証情報を記憶させる
本来テストしたい最初のページ（https://authenticationtest.com）へアクセスする
認証が必要なページへのリンクをクリックし、表示されたコンテンツを確認し、h1要素に「HTTP/NTLM Auth」の文字列が表示されているか、assertで確認する

こちら実際にScripted browserにて実行していただくと、リンククリック時のURLに認証情報を記載していなくても、テストが無事に成功することがご確認いただけます。

まとめ

どちらの方法も非常に簡単に対応できることがわかっていただけたと思います。

１つ目の方法に関しては、ヘッダーへ追加のみ、２つ目の方法に関しては、事前に認証が必要なページへアクセスすることで、その後の認証を省略することができました。お客様のポリシーや好みに応じていずれかの方法にてご対応いただくことができます。

なお、Scripted browserのテストは、テストの実行ごとにRuntimeのインスタンスが新規に生成されるため、各テストはキャッシュがクリアされた状態で行われます。

また、パスワード情報をスクリプトに直書きしたくない場合は、Secure credentialsも併用してご利用いただけます。

松川晋士, リードテクニカルサポートエンジニア

New Relic株式会社　リードテクニカルサポートエンジニア。大手電機メーカーでソフトウェアエンジニアとして、携帯電話の開発に従事。フィーチャーフォンに始まり、Android搭載のスマートフォンの開発に携わる。その後、創業して間もないベンチャー企業で新規のWebサービス及びモバイルSDKの開発から運用、サポートを経て現職。

이 블로그에 표현된 견해는 저자의 견해이며 반드시 New Relic의 견해를 반영하는 것은 아닙니다. 저자가 제공하는 모든 솔루션은 환경에 따라 다르며 New Relic에서 제공하는 상용 솔루션이나 지원의 일부가 아닙니다. 이 블로그 게시물과 관련된 질문 및 지원이 필요한 경우 Explorers Hub(discuss.newrelic.com)에서만 참여하십시오. 이 블로그에는 타사 사이트의 콘텐츠에 대한 링크가 포함될 수 있습니다. 이러한 링크를 제공함으로써 New Relic은 해당 사이트에서 사용할 수 있는 정보, 보기 또는 제품을 채택, 보증, 승인 또는 보증하지 않습니다.

780+ 개 통합을 사용해 무료로 스택 모니터링

모든 통합 보기

In this article

Scripted BrowserでBasic認証を必要とする場合のTips

方法１：Authenticationヘッダーを利用する方法

方法２：Chromeのキャッシュを利用する方法

まとめ

Tags

관련