REST APIなどを開発すると、避けては通れないものに認証があります。 最近はOAuth2 Providerを実装することが多いのですが、発行するアクセストークンにJSON Web Token（JWT）を利用しています。 JWTは名前の通り、RFC7519によって定義されたスキーマを持つJSONです。 JSONの各キーとして、RFCで定義されている標準的なキーと値のペア（Claim）を取ることにより、標準的な取り扱いが可能になります。 本記事では、JWTのClaimについて、OAuth2 Providerでのアクセストークンを発行する立場から、備忘録的にまとめたいと思います。 なお、JWTにはJOSE Headerのような、Claimとは別の仕様も含まれていますが、本記事ではClaimのみを対象とします。 アクセストークンとしてJWTを利用することの利点 JWTは単なるJSONのため、ア
<?php //POSTで受け取り $message = ($_POST['message'] ?? "no message"); $datetime = ($_POST['datetime'] ?? "no datetime"); //変数代入 $response['status'] = 'OK'; $response['message'] = $message; $response['datetime'] = $datetime; //jsonで返す echo json_encode($response); 基本的な使い方 APIにリクエストを投げる 特に説明はいらないと思いますが、URLを入力し、Methodを選択（ここではPOST）、送るパラメータをセットし、[Send]ボタンをクリックします。すると、レスポンスがBodyに表示されます。まあ、これだけでも十分便利です。 ただ、今回
Something went wrong! Hang in there while we get back on track Writing an API is almost a given with modern web applications. I’d like to lay out some simple guidelines and best practises for Rails API testing. We need to determine what to test and why it should be tested. Once we’ve established what we will be writing tests for, we will set up RSpec to do this quickly and easily. Basically we’ll
最近 Rails で API をつくりはじめました。1か月テスト書きまくって、だいたい書き方が落ち着いてきたので共有します。 もっとこうした方が良くない？というのをコメントまたははてブコメントしてくださったら泣いて喜びます！ 環境は下記のとおりです。 * rails 4.0.0 * rspec-rails 2.14.0 * factory_girl_rails 4.2.0 もくじ Rails でつくる API のテストの書き方（RSpec + FactoryGirl） 1. ベストプラクティス 2. RSpec の Request spec で書く 3. Capybara は使わない 4. GET のテスト例 1（データを 1件取得） (1) ステータスコードの明示 (2) モデルの個別の内容を返すときは、属性を列挙して確認 5. GET のテスト例 2（データを一覧取得） (1) 属性を
ども、@kimihomです。 API に関する基礎的な話で、なぜ API が重要なのか、APIの実装で注意する点について記述した。 今回はAPI開発において最も頭を悩ます、認証の問題について考えてみたい。 API における認証 よくあるログインが必要なページを考えてみていただきたい。 通常のWebアプリケーションであれば、Cookieという仕組みを使って毎回Webサーバーにアクセスするときにsession idというものを送信し、それとユーザー情報を紐付けたデータを取ってくることで、どんなユーザーからリクエストが来たのかをWebアプリケーション側で判断することができる。これにより、私たちはいつも閲覧しているWebアプリケーションが自分専用の画面として見れるようになっている。 これがAPIになると話は違ってくる。Cookieという仕組みが使えないのである。ということで、なんとかしてAPIにア
先日結婚式を挙げました。式中ご参列いただいた方と簡単に写真を共有したいなと思い、そういうマイクロサービスを作ってみました。ここではどのように実装していったのかを記憶が薄れぬうちに書いていこうと思います。 着想と仕様 自分が結婚式に参列する時、写真を撮るものの、主賓に送りそびれることがよくあって、だったらそのままさくさく送れたら楽じゃんねーと思っていました。で送りっぱなしだとグルーブ感がないので、出来たらその場でシェア出来たらよいかもと考えていました。それを踏まえて仕様としては、 その場でサクサク送れる 送った写真をリアルタイムに共有できる ことを目指しました。 全体構成 全体構成は以下のようになっています。 LINE Message APIを使ってLINEのチャンネルを参列者に登録してもらい、そこから写真を投稿してもらいます。webhookを介して画像データをサーバーに渡し、CDNに保存し
移転しました http://please-sleep.cou929.nu/20130121.html
コンテキスト あなたが開発しているサービスはユーザー向けにAPIを提供している。そして、APIを利用するにはユーザーは短寿命の認可情報(たとえばOAuth2トークン)を提示しなければならない。 ユーザーは認可情報が紐付いているアカウントの権限でリソースを読み取ったり、作成したり、所有したり、編集または削除したりする。 ここで、ユーザーは人間(が操作するユーザーエージェント)であることもあるが、人間の手を離れてバックグラウンドで自動実行されるプログラムかもしれない。 また、あなたは悪用目的でアカウントが大量登録されるのを防ぐためにCaptchaを利用したいと思っている。 さらに、課金目的で請求書送付先を登録させたいとも思っているかもしれない。 問題 プログラムが利用するアカウントを安全に管理するのがユーザーにとって困難である。 プログラムは自分でCaptchaを解いたりEメールを受け取るのが
Redirecting… Click here if you are not redirected.
数あるIssue管理システムがたくさんあるが、JIRAだの、Redmineだなの、Trelloだのあるし、 Github issueにZenHubを利用するのが最近のホットなツールかも知れないね。 うちの会社では、非エンジニアでも入力しやすさを重視して、Backlogを利用している。 Backlogは、RedmineっぽいののSaaSを会社で使っている それのバーンダウンチャートがどうも会社で使っている方式と合わない。 おまけにバーンダウンチャートは高めのプランでしか使えない、 そこでいままでGem作ったこともなかったしラッパーライブラリを作って自前でバーンダウンチャートを作ることにした。 幸いRESTFulなWebApiをサービスの開発者とのNulabさんが公開している。 Backlog APIドキュメント これを薄くラップしたものを作成した。 Gemの公開方法は一つ前のポスト kony
Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article? これは Enchant の開発者である Vinay Sahni さんが書いた記事「Best Practices for Designing a Pragmatic RESTful API」1を、ご本人の許可を得て翻訳したものです。 RESTful な WebAPI を設計しようとすると、細かなところで長考したり議論したりすると思います。また、他の API に倣ってやってはみたものの、本当にそれでいいのか、どうしてそうしているのか分からない、何てことも少なくはないと思います。 この記事では、そのようなハマリどころについて Vinay さん
Photo by Gonzalo Baeza | Flickr - Photo Sharing! RailsでJSONを返すAPIを作成し、また、APIのテスト方法も説明します。 JSONを返すAPIは、RailsのActiveSupportより拡張されたto_jsonメソッドとDMMが開発したjbuilderというGemを使います。 APIのテストにはおなじみのRSpec3を使います。 動作確認 Rails 4.1.7 jbuilder 2.2.6 rspec-rails 3.1.0 factory_girl 4.5.0 目次 1. 前提条件 2. APIの作成 2.1. 1つのコントローラーでHTMLやJSONを返すAPI 2.2. JSONのみを返すAPI 2.3. APIのバージョニング 3. APIのテスト 3.1. テストファイルの準備 3.2. 一覧(index)APIのテス
When adding a Grape API to an existing Rails application you have a few options for user authentication. Probably the simplest and most basic way to authenticate an API is by issuing API keys to your users. How it works…User submits their Username/Password to the API.API authenticates the user and returns an API Key.For all subsequent API requests, the user submits the key with their request. This
2016/06/11のフロントエンドカンファレンスのLTで発表した資料です。
背景 WEBサービスで駅とか路線のマスター情報とか使いたいときが結構あると思います。自分でマスター管理するのは大変なので、どこかにお願いしたいですよね。そんな時はこちら。 無料 駅データ.jp 無料（有料プランもあり） 事業者マスタ、路線マスタ、駅マスタ、接続駅マスタがCSVで提供されます APIでの提供も用意されています 商用利用やデータの改変についても制約がなく使い勝手が良さそうです 有料契約すると取得できる情報がちょっと詳細になります リクルートWEBサービス 無料 APIでの情報提供になりますが、沿線マスタAPIで全件取得できますので、それをもとにAPIをぐるぐる回せば自分で駅マスターは作れそうです ただ利用者としてリクルート社のコンテンツをマッシュアップしてサービス提供したい人向けのようなので、全く無関係のシステム・サービスで利用しようとしている場合は利用許可がでないかもしれませ
FiNC さんの社内マイクロサービス勉強会と、表参道.rb にて、そろそろリリースされそうな Rails 5 におけるメジャーフィーチャの一つ Rails::API について話しました。 雑感 スライド読むと分かるように、Rails::API は API サーバを作る時の銀の弾丸でもなんでもなくて、条件に合致したときに使うとちょっとだけ速くなりますよ、軽くなりますよという機能なのでした。 Rails::API の機能面としてはそれだけなのだけど、Rails は Rack Middleware や ActionController::Base 内の Module が疎になっていて、着脱が簡単なんですよというのを示す良い例にもなっていると思います。使っていない Middleware や Module を外すことで、手軽にちょっぴり速く／軽くできるので、API サーバに限らず不要なものがある場合
この変更により、これまでメールを送信していた箇所が全てログファイルへの出力へと変更されました。ただし、これだけではログを検索する際に、各サーバにログインして、ログの内容をgrepなりptコマンドで検索する手間が発生します。そういった問題を解決するためにムームードメインではFluentdとTreasure Dataを利用しています。 上記の図のように各サーバからcollectorサーバにFluentdでログを集め、collectorサーバがTreasure Dataにログを送信しています。Treasure Dataに送信したデータはSQLに似たHiveQLを利用して検索したり、BIツールと組み合わせることにより数値を可視化することができます。 自分事化する仕組みづくり さて、ログを一箇所に集め、検索できる仕組みはできました。次のステップとして自分事化する仕組みをご紹介します。 SlackやG
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
