はじめに
プッシュ通知はFirebaseなどに任せる方も多いかと思いますが、業務で自前でサーバーをたてて構築する機会があったのでまとめておきます。
類似する記事も多いですが、記事が古くgoとgaurunのバージョンが噛み合ってなかったり
証明書の作成に関して、上手くいかないところもあったので、備忘録がわりに記録しておきます
使い方
http://IPアドレス:設定したポート/push
に対して
{
"notifications" : [
{
"token" : ["xxx"],
"platform" : 1, //iOSは１、Androidは2
"message" : "メッセージ１",
"title": "タイトル１",
"subtitle": "サブタイトル１",
"badge" : 1,
"category": "category1",
"sound" : "default",
"content_available" : false,
"mutable_content" : false,
"expiry" : 10,
"extend" : [{ "key": "url", "val": "..." }, { "key": "intent", "val": "..." }]
},
{
"token" : ["xxx"],
"platform" : 2,
"message" : "メッセージ２",
"title": "タイトル２",
"subtitle": "サブタイトル２",
"badge" : 1,
"category": "category1",
"sound" : "default",
"content_available" : false,
"mutable_content" : false,
"expiry" : 10,
"extend" : [{ "key": "url", "val": "..." }, { "key": "intent", "val": "..." }]
},
]
}
上記の形式のJSONをPOSTすると,token欄に書かれたデバイストークン（後述にて説明）を持つ端末に各オブジェクトの内容でプッシュ通知が送信される
一つの通知オブジェクト（“notifications”:の各要素）の”token”:欄にデバイストークンは配列として複数登録できるので、同じメッセージを
複数の端末に送信することができる。
次にプッシュ通知の送信に最低限必要な証明書とデバイストークンについて解説する。
必要なもの
プッシュ通知を送るのに必要なものは
- アプリに紐づくプッシュ通知用の証明書と秘密鍵
（開発用と、開発・本番両用の２種類がある。送信用のライブラリによって必要な形式が違う） - プッシュ通知を送りたい各端末のデバイストークン
である
１． 証明書と秘密鍵
以下に今回採用したGauranライブラリに必要な証明書のMacOSでの作成手順を簡単に説明する。
１．アプリのAPNsDeveloperPlatformcert.cer
２．cert.cer(key.p12とする)
３．この２つを書類フォルダに入れたと仮定して、ターミナルにて以下のコマンドを入力し、証明書と秘密鍵のpemファイルを作成
$ openssl x509 -in ~/Documents/cert.cer -inform DER -outform PEM -out cert.pem
$ openssl pkcs12 -in ~/Documents/key.p12 -out key.pem -nodes
この手順で作成された２つのpemファイルをscpなりrsyncなどででプッシュ通知送信用のサーバーの任意のディレクトリに配置し、後述の設定ファイルにて読み込むことで、プッシュ通知を送信することができる。
２． デバイストークン
デバイストークンは各iOSアプリのソースにてAppleにリクエストを送る処理を記述することで取得できる。
(参考 : Swiftでプッシュ通知を送ろう！ )
取得したデバイストークンを、例えばログイン時にユーザー情報と一緒にサーバー側に送ることで、ユーザーと端末の紐付けをDB等に保存して、任意のタイミングでプッシュ通知を送ることができる。
デバイストークンはアプリと端末の組み合わせに対して一意であり、同じ端末でもアプリが異なれば、プッシュ通知を送るのに必要なデバイストークンは異なるので、たとえばあるユーザーに関連アプリ別に通知を送りたければ、それぞれのアプリで取得したデバイストークンをすべてサーバー側は保存する必要がある
次ページにて今回のサーバーについての環境構築の手順を説明する。
環境構築の手順
OS:ubuntu 20.04
# gitをインストール
sudo apt install git
# gaurunのリリースノートを見て対応するバージョンのgoをダウンロード（ここを間違えてビルドできずにハマった）
Wget https://storage.googleapis.com/golang/go1.13.12.linux-amd64.tar.gz
以下に配置
sudo tar -C /usr/local -xzf go1.13.12.linux-amd64.tar.gz
# 環境変数を設定する
export GOPATH=$HOME/go
export GOROOT=/usr/local/go
export PATH=$PATH:/usr/local/go/bin:$GOROOT/bin:$GOPATH/bin
# ホームディレクトリにviで.bash_profileを作成し環境変数のログイン時設定を以下のように記述
echo “GOPATH=$HOME/go”
echo “GOROOT=/usr/local/go”
echo “$PATH:/usr/local/go/bin:$GOROOT/bin:$GOPATH/bin”
# ホームディレクトリにgoのアプリ用のディレクトリを作成
mkdir $HOME/go
# Gauranのインストール：https://github.com/mercari/gaurun
go get -u github.com/mercari/gaurun/...
# glideのインストール
go get -u github.com/Masterminds/glide
Gaurunソースディレクトリに移動
cd /home/username/go/src/github.com/mercari/gaurun
# makeコマンドでビルドする
make
上記の環境構築と設定ファイルの編集（今回の設定を次ページにて解説）をした後に、
Gaurunソースディレクトリにて
bin/gaurun -c conf/gaurun.toml&
を実行することで、プッシュ通知用のサーバーが起動する
ライブラリのソースを変更した場合は
kill プロセス番号
コマンドでサーバーを落として、makeコマンドを実行し再度起動させる
設定ファイルのみの変更の場合は、サーバーを落として再起動のみでよい
###設定ファイルの編集例
vi /home/username/go/src/github.com/mercari/gaurun/gaurun.toml
[core]
port = "1056" # Gaurun用のポートを任意で設定（今回はデフォルト値）
# port = "unix:/tmp/gaurun.sock"
workers = 8
queues = 8192
notification_max = 100 # 一度にPOSTできる最大の通知の数
[android]
apikey = "YOUR_API_KEY"
enabled = true
timeout = 5 # sec
keepalive_timeout = 30
keepalive_conns = 4
retry_max = 1
[ios]
pem_cert_path = "certificates/cert.pem" # 証明書を保存したパスに変更（カレントはgaurunディレクトリ）
pem_key_path = "certificates/key.pem" # 証明書を保存したパスに変更
sandbox = true
enabled = true
timeout = 5
keepalive_timeout = 30
keepalive_conns = 6
retry_max = 1
topic = "jp.yourdomainname"
[log]
access_log = "/var/log/gaurun/access.log"
error_log = "/var/log/gaurun/error.log"
level = "error"