Google OpenID 導入分享

首先，先到下面這個連結註冊。
https://www.google.com/accounts/ManageDomains

註冊的步驟很簡單，只要填些資料後認證網站就好，我就不說明了，直接來看Google OpenID的說明文件。


這次只介紹使用OpenID，所以還蠻單純的

Step 1 : Get OpenID endpoint
首先，對https://www.google.com/accounts/o8/id這個網址Get，正常來說你會下載一個叫做"id"沒有副檔名的檔案(除非你可以吃application/xrds+xml header)，用notepad之類的打開後，會發現裡面內容是個類似XML格式的資料，這就是Google回傳的XRDS文件，內容是OpenID提供者(Google)端點位址，在<URI></URI>之中的網址就是我們要的東西。




Step 2 : Request OpenID Identity
這邊，簡單來說只要對剛剛取得的URI丟出規定的Request parameters就好，下面為會用的到參數，詳細的請看Google的文件。

Request OpenID Identity
參數名稱	說明
openid.mode	Google可接受checkid_immediate或checkid_setup，但使用checkid_immediate需另外設別的參數，所以這邊我填入checkid_setup
openid.ns	填入http://specs.openid.net/auth/2.0
openid.return_to	取得Request Token後導向的網址
openid.assoc_handle	可不填
openid.claimed_id	可不填，我是填入http://specs.openid.net/auth/2.0/identifier_select
openid.identity	可不填，我是填入http://specs.openid.net/auth/2.0/identifier_select
openid.realm	可不填，我是填入程式所在的網域

在第一步我取得的endpoint是https://www.google.com/accounts/o8/ud，所以送出的整串需求會是這樣

https://www.google.com/accounts/o8/ud?
openid.ns=http://specs.openid.net/auth/2.0
&openid.claimed_id=http://specs.openid.net/auth/2.0/identifier_select
&openid.identity=http://specs.openid.net/auth/2.0/identifier_select
&openid.return_to=http://yourwebsite.com/AuthSub.aspx
&openid.realm=http://yourwebsite.com/&openid.mode=checkid_setup

送出後，理論上只要你成功，就會看見下面請求確認的畫面(或是先Login Google Account才看到下面的畫面)

上圖的確認畫面是順便要email的畫面，如果按照Step 2所說的參數送出是不會有那行的。

確認後，Google會把頁面導回openid.return_to設定的位址

回傳的樣子會長的像這樣

http://yourdomain/AuthSub.aspx?
openid.ns=http%3A%2F%2Fspecs.openid.net%2Fauth%2F2.0
&openid.mode=id_res
&openid.op_endpoint=https%3A%2F%2Fwww.google.com%2Faccounts%2Fo8%2Fud
&openid.response_nonce=2010-07-20T08%3A05%3A45Z13jt7jYD8hQSFA
&openid.return_to=http%3A%2F%2Fyourwebsite.com%2FAuthSub.aspx
&openid.assoc_handle=AOQobUeUjv0ABpLSc8OjMpRSJV4It_Wg6ZXjOU93FKv6K_L8Qx92TO4S
&openid.signed=op_endpoint%2Cclaimed_id%2Cidentity%2Creturn_to%2Cresponse_nonce%2Cassoc_handle
&openid.sig=7Qph6mxuOAqYYIocTpc%2FyLFvR6o%3D
&openid.identity=#####identity#####
&openid.claimed_id=#####identity#####

其中的openid.identity就是OpenID用來辨別使用者的唯一值，我們就可以拿這個值去運用了。

Step 3 : Get Addition Info

其實在上一步就可以結束了，不過Google文件中有提到可以在取得使用者識別碼時，同時取得一些資訊，就順便介紹一下。

Get Addition Info
參數名稱	說明
openid.ns.ax	填入http://openid.net/srv/ax/1.0
openid.ax.mode	填入fetch_request
openid.ax.required	需求之資訊，有country,email,firstname,language,lastname可選擇，如果同時要求多項則用逗號作為分隔
openid.ax.type.country	有使用到的話填入http://axschema.org/contact/country/home
openid.ax.type.email	有使用到的話填入http://axschema.org/contact/email或http://schema.openid.net/contact/email
openid.ax.type.firstname	有使用到的話填入http://axschema.org/namePerson/first
openid.ax.type.language	有使用到的話填入http://axschema.org/pref/language
openid.ax.type.lastname	有使用到的話填入http://axschema.org/namePerson/last

使用上就是在Step 2 的Request上加上Step 3所需的參數，我只多加了需求email，所以Request會長的像下面這樣

https://www.google.com/accounts/o8/ud?
openid.ns=http://specs.openid.net/auth/2.0
&openid.claimed_id=http://specs.openid.net/auth/2.0/identifier_select
&openid.identity=http://specs.openid.net/auth/2.0/identifier_select
&openid.return_to=http://yourwebsite.com/AuthSub.aspx
&openid.realm=http://yourwebsite.com/&openid.mode=checkid_setup
&openid.ns.ax=http://openid.net/srv/ax/1.0
&openid.ax.mode=fetch_request
&openid.ax.type.email=http://schema.openid.net/contact/email
&openid.ax.required=email

而收到的值會長的像下面這樣

http://yourdomain/AuthSub.aspx?
openid.ns=http%3A%2F%2Fspecs.openid.net%2Fauth%2F2.0
&openid.mode=id_res
&openid.op_endpoint=https%3A%2F%2Fwww.google.com%2Faccounts%2Fo8%2Fud
&openid.response_nonce=2010-07-20T08%3A22%3A44Zg6DFJKBUAvwT8w
&openid.return_to=http%3A%2F%2Fyourwebsite.com%2FAuthSub.aspx
&openid.assoc_handle=AOQobUcXKwMlCGaFohdD6hPXVzUUtNMJWPhYeoeFoJ3Kt0CaGJqP5k1h
&openid.signed=op_endpoint%2Cclaimed_id%2Cidentity%2Creturn_to%2Cresponse_nonce%2Cassoc_handle%2Cns.ext1%2Cext1.mode%2Cext1.type.email%2Cext1.value.email
&openid.sig=zZYOqWnLSrheQW31gsCVBq50BaE%3D
&openid.identity=#####identity#####
&openid.claimed_id=#####identity#####
&openid.ns.ext1=http%3A%2F%2Fopenid.net%2Fsrv%2Fax%2F1.0
&openid.ext1.mode=fetch_response
&openid.ext1.type.email=http%3A%2F%2Fschema.openid.net%2Fcontact%2Femail
&openid.ext1.value.email=user_email

這樣就可以在取得OpenID識別的同時，取得一些使用者資訊了 (當然要使用者按下同意才有用)