徒然Blog

アメブロ。XMLRPCは使えないのでAtomAPIを使う必要がある。
そのまとめ。

１）WSSE認証
HTTP で X-WSSE ヘッダを追加し、ルートAtomエンドポイントに投げる。

アメブロのルートAtomエンドポイントは２０１０年１月現在は↓で大丈夫。
http://atomblog.ameba.jp/servlet/_atom/blog

追加するヘッダは↓のような感じ。もちろん、↓を投げてもうまくいかない。
X-WSSE: UsernameToken Username="xxxxxxx", PasswordDigest="ZCNaK2jrXr4+zsCaYK/YLUxImZU=", Nonce="Uh95NQlviNpJQR1MmML+zq6pFxE=", Created="2005-01-18T03:20:15Z"

Username　・・・　アメブロでログインするときのID。
PasswordDigest　・・・　nonce + created + password　を sha1 でハッシュ値を取得し、Base64エンコードしたもの。（nonce、created、passwordは後述）
アメブロの場合、passwordをmd5でハッシュ値を取得する必要がある。その際、アルファベットはすべて小文字に変換する。

PHPでbase64エンコード、sha1・md5 計算するかは分からないのでイメージだけど↓のような感じ。
↓のコードをそのまま入れても絶対動かない。
toBase64( sha1( nonce . created . toLower( md5( password ) ) ) )

それぞれの説明。
toBase64　・・・　Base64エンコードする関数。
sha1　・・・　引数の文字列から、sha1ハッシュ値を取得する関数。
toLower　・・・　文字列を、大文字から小文字（A -> a）に変換する関数。
md5　・・・　引数の文字列から、md5ハッシュ値を取得する関数。

nonce　・・・　ランダム文字列。自分の場合は、２０バイト分のランダムな文字列を使ってた。
　ランダムといいつつ、”abc”とか固定文字でもOKだった。
　1/29訂正・・・Base64変換のタイミングについて誤りがあったので訂正。
　PasswordDigest に渡す際は通常の文字列（例："abc"）を、X-WSSEヘッダのnonce引数にはBase64変換した文字列（例：toBase64("abc")）を指定する。

password　・・・　アメブロにログインするときのパスワード。
　上で書いたとおり、PasswordDigestを生成する際、アメブロに限り、パスワード文字列を md5 ハッシュ値計算してやる必要があるので注意。

created　・・・　時間。例にあるような 2005-01-18T03:20:15Z という感じのフォーマット（日付と時間の区切りに半角大文字の T を、文字列の最後に Z をつければOK）。
　PasswordDigestを生成する際も、そのままの文字列を渡してやればOK。

このヘッダをつけて、GETで送信すればOK。
成功したら、XMLが返ってくる。
そのXMLに、いろいろなURLがついてるので保存しておくこと。

失敗したら、以下のようなコードが返ってくる。
４０１　・・・　X-WSSE ヘッダがおかしい。ほかは大丈夫。
４０３　・・・　変なURLに送ったとか、根本的におかしい。
上以外　・・・　わからん


２）記事情報の取得
X-WSSE認証がうまくいけば、とりあえず第一関門はクリア。
次は記事情報の取得。
１）でゲットしたXMLからFeedのURLをゲットする。
あとは１）のやつと同じで、エンドポイントを↑でゲットしたURLに変えればいいだけ。


３）新規投稿
新規投稿はそれほど難しくない。

以下のXMLをPOSTメソッドで送信する。
もちろん、X-WSSEヘッダはつけておく。
それ以外につけたヘッダは ContentType を application/x.atom+xml にしたぐらい。
ヘッダの内容は、１）と同じでOK。

<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://purl.org/atom/ns#"
xmlns:app="http://www.w3.org/2007/app#"
xmlns:mt="http://www.movabletype.org/atom/ns#">
<title>記事のタイトル</title>
<content type="application/xhtml+xml">
<![CDATA[記事の本文]]>
</content>
<updated>時間</updated>
</entry>

contentは、<![CDATA]]>でくくってやることで、本文にHTMLタグが使えるようになる。
updatedはいるのかいらないのかよく分からない。
試してないけど、多分いらないと思う。

試してできなかったこと
　本文に対する追記（mt:textMore）はダメ。
　公開範囲（app:draft）もダメ。常に全力公開。
タグがxx:～ってなってるやつは多分ダメなんじゃないかな。


４）記事編集
２）でゲットした情報に各記事のEditUrlが書いてあるから、そいつに３）の内容を投げれば、記事編集ができる。
もちろん、本文やタイトルを変えて送る。


５）記事削除
２）のEditUrlに、DELETEメソッドを投げればOK。


まとめ。
とにかく鬼門は１）。
それさえ通れば、後はなんとでもなる。
↓とか結構参考になった。
http://www.so-net.ne.jp/blog/sitetour/atom_api_spec.html


1/29追記
C#のソースコード。

//X-WSSEヘッダを取得
private string getWsseHeader()
{
string wsse = "";
string nonce = CreateNonce();
string created = getDate(DateTime.Now);
System.Security.Cryptography.SHA1Managed shasp =
new System.Security.Cryptography.SHA1Managed();
string nonce64 = nonce;

//CreateNonceで生成した文字列はBase64エンコードされているので、それを元に戻す。
string noncestr = base64toString(nonce);

//wsseヘッダを生成
wsse = string.Format("UsernameToken Username=\"{0}\", PasswordDigest=\"{1}\", Nonce=\"{2}\", Created=\"{3}\"",
id,
getPasswordDigest(noncestr, created),
nonce64,
created);

return wsse;
}


//X-WSSEヘッダ用のPasswordDigestを取得
private string getPasswordDigest(string nonce, string created)
{
string password = pass;
byte[] data = System.Text.Encoding.ASCII.GetBytes(password);
System.Security.Cryptography.MD5CryptoServiceProvider md5 =
new System.Security.Cryptography.MD5CryptoServiceProvider();

byte[] bs = md5.ComputeHash(data);
password = BitConverter.ToString(bs).ToLower().Replace("-", "");

byte[] temp = Encoding.ASCII.GetBytes(nonce + created + password);

System.Security.Cryptography.SHA1Managed sha1 = new System.Security.Cryptography.SHA1Managed();
return Convert.ToBase64String(sha1.ComputeHash(temp));
}


//Base64文字列を１バイト文字列に変換
private string base64toString(string base64)
{
string buf = Encoding.ASCII.GetString(Convert.FromBase64String(base64));
return buf;
}


//Nonceを生成（ランダムで生成した２０バイトの文字列）
//戻り値：Base64エンコードしたNonce文字列。
// PasswordDigestにそのまま使えるが、X-WSSEヘッダのnonce値はデコードする必要がある。
private string CreateNonce()
{
byte[] temp = new byte[20];
int seed = Environment.TickCount;
(new Random(seed++)).NextBytes(temp);
temp = Encoding.UTF8.GetBytes(new Random().Next().ToString());
return Convert.ToBase64String(temp);
}


2/11さらに追記
PHPでも書いてみた。
これだと、一応HTTPステータスが２００になるけど、エンドポイントのURLをどうやって取得するのかよく分からなかった。
（ユーザ名やパスワードをいじくると４０１が戻ってきたので、たぶん大丈夫だと思う、というレベル）
WSSEヘッダを作る参考にでもなれば、ということで。

<?php

ini_set( 'display_errors', 1 );

$user="ユーザID";
$pass="パスワード";

$ret = init_atom($user,$pass);

echo $ret;

?>

<?php
//
//　wsse認証を突破するまでのサンプル
//
//　http://d.hatena.ne.jp/pha/20081203/1228300535　に掲載のソースコードをベースに開発
//
function init_atom($user,$pass){

//PEAR::HTTP_Requestを使う
require_once("HTTP/Request.php");
$posturl = "http://atomblog.ameba.jp/servlet/_atom/blog";
$created = date("Y-m-d\TH:i:s\Z");

//WSSE認証用データの作成
$pass = md5($pass);
$nonce ="abcdefghijk";
$pass_digest = base64_encode(pack('H*', sha1($nonce.$created.$pass)));
$wsse = 'UsernameToken Username="'.$user.'", PasswordDigest="'.$pass_digest.'", Created="'.$created.'", Nonce="'.base64_encode($nonce).'"';

//HTTP_Request()より送信
$req = new HTTP_Request();
$req->addHeader('X-WSSE',$wsse );
$req->addHeader('Content-Type', 'application/x.atom+xml');
$req->setMethod(HTTP_REQUEST_METHOD_GET);
$req->setURL($posturl);

$req->sendRequest();

return $req->getResponseCode();
}
?>