1 files changed, 75 insertions, 0 deletions
diff --git a/files/ja/web/api/identitymanager/request/index.html b/files/ja/web/api/identitymanager/request/index.html
new file mode 100644
index 0000000000..df3d91bdeb
--- /dev/null
+++ b/files/ja/web/api/identitymanager/request/index.html
@@ -0,0 +1,75 @@
+---
+title: navigator.id.request
+slug: Web/API/IdentityManager/request
+tags:
+  - BrowserID
+  - DOM
+  - Gecko DOM Reference
+  - Persona
+  - Security
+translation_of: Archive/IdentityManager/request
+---
+<div>
+ {{ ApiRef }} {{ non-standard_header }}</div>
+<div class="note">
+ <strong>注記:</strong> この機能は、まだどのブラウザでもサポートされていません。Persona を使用する Web サイトは、そのページに <a href="https://login.persona.org/include.js" title="https://login.persona.org/include.js">ポリフィルライブラリ</a> を含めなければなりません。</div>
+<h2 id="Summary" name="Summary">概要</h2>
+<p>この関数は、Web サイトが <a href="/ja/docs/Persona" title="Persona">Persona</a> を使用してユーザの認証ができるようにします。この関数は click ハンドラから呼び出されなければなりません。例えば、ユーザがページ上の「log in with Persona」ボタンをクリックした時に呼び出します。</p>
+<p>呼び出された時、<code>navigator.id.request()</code> がユーザにログインするメールアドレスを選択するように求め、さらにユーザの証明書が期限切れの場合は ID プロバイダで認証するように求めます。これらが完了した後、ユーザのメールアドレスとパスワードを含む署名付きの <strong>アサーション</strong> が生成されます。このアサーションは、{{domxref("navigator.id.watch()")}} で登録された <code>onlogin</code> コールバックに渡されます。</p>
+<p>この関数は、{{domxref("navigator.id.watch()")}} と連動して <strong>使用されなければなりません</strong>。</p>
+<h2 id="Syntax" name="Syntax">構文</h2>
+<pre class="syntaxbox">navigator.id.request();
+navigator.id.request({siteName: 'Example Site', siteLogo: '/logo.png'});
+navigator.id.request({termsOfService: '/tos.html', privacyPolicy: '/privacy.html'});
+</pre>
+<h3 id="Parameters" name="Parameters">引数</h3>
+<dl>
+ <dt>
+  <code>oncancel</code> {{ optional_inline() }}</dt>
+ <dd>
+  この関数は、ユーザが ID をサイトと共有することを拒否した場合に呼び出されます。</dd>
+ <dt>
+  <code>privacyPolicy</code> {{ optional_inline() }}</dt>
+ <dd>
+  Web サイトのプライバシーポリシーのページへの絶対パスまたは URL。この引数を指定する場合、<code>termsOfService</code> も指定しなければなりません。<code>termsOfService</code> と <code>privacyPolicy</code> の両方を与えた場合、ログインダイアログに "you confirm that you accept this site's Terms of Use and Privacy Policy." というメッセージを表示してサイトの利用規約とプライバシーポリシーを知らせます。これには、それぞれのページへのリンクが含まれます。<code>termsOfService</code> が指定されない場合、この引数は効果がありません。</dd>
+ <dt>
+  <code>returnTo</code> {{ optional_inline() }}</dt>
+ <dd>
+  新しいユーザが最初にメールアドレスの検証を完了した後に表示されるページへの絶対パス。パスは '<code>/</code>' で始めなければなりません。この引数は、Mozilla のフォールバック ID プロバイダにより証明されたユーザにのみ影響します。</dd>
+ <dt>
+  <code>siteLogo</code> {{ optional_inline() }}</dt>
+ <dd>
+  ログインダイアログに表示する、画像への絶対パス。パスは '<code>/</code>' で始めなければなりません。また、SSL 経由の読み込みが可能でなければなりません。大きなサイズの画像は 100×100 ピクセルに収まるサイズに縮小されます。</dd>
+ <dt>
+  <code>siteName</code> {{ optional_inline() }}</dt>
+ <dd>
+  ログインダイアログに表示する、サイトのプレーンテキスト表記。Unicode 文字列とスペースは使えますが、マークアップはできません。</dd>
+ <dt>
+  <code>termsOfService</code> {{ optional_inline() }}</dt>
+ <dd>
+  Web サイトの利用規約のページへの絶対パスまたは URL。この引数を指定する場合、<code>privacyPolicy</code> も指定しなければなりません。<code>termsOfService</code> と <code>privacyPolicy</code> の両方を与えた場合、ログインダイアログに "you confirm that you accept this site's Terms of Use and Privacy Policy." というメッセージを表示してサイトの利用規約とプライバシーポリシーを知らせます。これには、それぞれのページへのリンクが含まれます。<code>privacyPolicy</code> が指定されない場合、この引数は効果がありません。</dd>
+</dl>
+<h2 id="Example" name="Example">例</h2>
+<pre class="brush:js;">var signinLink = document.getElementById('signin');
+if (signinLink) {
+  signinLink.onclick = function(evt) {
+    // ユーザから署名付き ID アサーションを要求する
+    navigator.id.request({
+      siteName: 'My Example Site',
+      siteLogo: '/logo.png',
+      termsOfService: '/tos.html',
+      privacyPolicy: '/privacy.html',
+      returnTo: '/welcome.html',
+      oncancel: function() { alert('ユーザが ID の共有を拒否しました。'); }
+    });
+  };
+}</pre>
+<h2 id="Specification" name="Specification">仕様</h2>
+<p>まだどの仕様書にも含まれていません。</p>
+<h2 id="See_also" name="See_also">関連情報</h2>
+<ul>
+ <li><a href="/docs/Persona" title="Persona">BrowserID</a></li>
+ <li>{{domxref("navigator.id")}}</li>
+ <li>{{domxref("navigator.id.watch()")}}</li>
+ <li>{{domxref("navigator.id.logout()")}}</li>
+</ul>