OAuth認証とは何か?なぜダメなのか - 2020冬 - r-weblife
こんばんは。ritouです。 Digital Identity技術勉強会 #iddance Advent Calendar 2020 1日めの記事です。 qiita.com 初日なのでゆるふわな話をしましょう。 何の話か もうだいぶ前ですね。9月のお話です。こんなTweetを見かけました。 社内Slackにいる「OAuth認証」と書くと訂正してくれるbotが丁寧な解説をするようになっていた 認証(Authentication)と認可(Authorization)は間違えやすいわりにミスると甚大な被害をもたらしがちなので、常日頃から意識を高めていきたいですね pic.twitter.com/oVQxBgZcHS— greenspa (@greenspa) 2020年9月28日 このbotに対する思うところはもう良いです。 今回は、「OAuthの仕様に沿ってID連携を実装するいわゆる"OAut
【令和】Microsoft の元号対応が迷走している件 - Qiita
はじめに 私は Delphi 使いです。なので、新元号対応は Win32 API に依存していることになります。 Delphi の FormatDateTime() / DateTimeToString() は元号レジストリを参照するので、レジストリに新しい元号が追加されれば新元号対応できる...はずでした。 Era Handling for the Japanese Calendar (Microsoft) 元号が改正された場合の西暦と和暦の相互変換について [JAPAN] (Embarcadero) Delphi／C++Builder 10.2.3 Tokyoの新元号対応について (Embarcadero) 事の始まり 4/10 の井之上@エンバカデロさんのツイートが発端でした。 Windows 10 1809 向けに今日付け(2019/04/10) でリリースされたアップデートのうち
【障害報告】ログイン直後APIを甘く見てたらアプリ利用不能な障害が起きた話 - Qiita
こんにちは。鹿島(@kashitaka)です。リクルートでサーバーサイドエンジニアをやってます。 今年も色々ありましたが、中でも社内向けのLT会で発表して、バックエンド・フロントエンド・ネイティブ関係なく面白いと好評だった「ある障害の振り返りと学び」をこの場にも書こうと思います。 TL; DR ログイン直後に叩く状態取得系のAPIの設計に気をつけよう ログイン直後APIはログインAPIと同じくらい重要 ログイン直後APIに多くの処理、複雑なロジックは盛り込まない ログイン直後APIではトランザクションデータはなるべく扱わない 障害内容 一部ユーザーでアプリが全く利用できない 私が担当しているプロダクトで「あるユーザーがiOSアプリでログインするとフリーズして全く利用できないようだ」という報告を受けました。一部ユーザーとはいえアプリが完全に利用不能な状態というのは緊急事態です。 システムにつ
なぜポストREST APIが求められるのか？ REST APIがカバーできない2つの要因とその対策 - Morning Girl
なんだか珍しく、あおり気味のタイトルにしてしまいました。 最近読んだ以下の記事が大変おもしろかったので、今まで私の中で度々反芻していたものを文章としてまとめてみました。 gihyo.jp なぜ今GraphQLが騒がれているのか。ポストRESTが求められている理由、なぜポストRESTが求められなければいけないのか？ ポストRESTの登場によって私たちにとって何が嬉しくなるのか？ そのあたりを色々と触れていきたいと思います。 本文に入る前に ここでは、RESTと記載していものに、REST ful であることも含めています。RESTの推奨（規約ではない）に準拠して開発されたAPIをREST Fulと呼ぶのであって、そこにAPIとしての違いは無いためです。 どちらかと言えば、私の意識としてはパブリックなAPI、オープンデータ用のAPIであったり、KintoneやSANSAN、Salesforce、
トークンを利用した認証・認可 API を実装するとき Authorization: Bearer ヘッダを使っていいのか調べた - Qiita
トークンを利用した認証・認可 API を実装するとき Authorization: Bearer ヘッダを使っていいのか調べたAPIOAuthWeb TL;DR HTTP でトークンを利用した認証・認可をする手法として RFC 6750 がある OAuth に限らず、トークンを利用して認証・認可する機構の一部として Authorization: Bearer ヘッダを使うことができる 使い方について詳しくはこの記事の下のほうに書いた 要求 トークンを利用した認証・認可機構を持つ API を作りたい クライアントがトークンを HTTP リクエストに含めて送信し、サーバはトークンを検証してリソースへのアクセスを許可したい Authorization: Bearer トークン ヘッダでトークンを送る API あるよね、ああいうやつ 疑問 Authorization: Bearer ヘッダは OA
HTTP APIの詳細なエラー情報をレスポンスに持たせるための仕様
今日では HTTP(s) で API が公開されることは当たり前の時代ですが、エラーをアプリケーションにどう伝えるかは、個々の API の設計に依存していました。特に、HTTP ステータスコードは有限であり、元々持っている意味があるので、自由に使うことはできません。API はそのドメインごとにもっと複雑で細かなエラー情報があるはずで、それらはレスポンスボディに載せてアプリケーションに伝えることになりますが、その書式に規定は今までありませんでした。 HTTP API にて、アプリケーションにエラー情報を伝達するための（レスポンスボディに載せられる）標準的な形式が、RFC7807 Problem Details for HTTP APIs で定められています。適用例としては、以下のようになります。 HTTP/1.1 403 Forbidden Content-Type: application
The Collaborative API Development Platform
New Release - Insomnia 8.0 is finally here with Scratch Pad, Real-Time Collaboration, Enterprise SSO, AI-Generated Testing Design, debug, and test APIs locally or in the cloudChoose Local, Cloud, or Git storage to build better APIs collaboratively with a dev-friendly UI, built-in automation, and an extensible plugin ecosystem. Get Started for Free
アノテーションからドキュメントを作れるswaggerの使い方 - gong023の日記
swagger の概要と、基本的な使い方をサンプルを交えて書く。 なお、終始 PHP なので気をつけて下さい。 swagger の概要 開発ドキュメントをどうやって書くかという話題は常々ある。そして一番素直なアプローチを取ると、大抵 wiki みたいなアプリケーションを用意して、そこにドキュメント書こうぜという話になる。しかし、この管理は割とすぐ破綻してしまう。 理由はいろいろあるが、最新のコードに追従できなくなるとか、統一されたフォーマットを保証できず書き手によっては何を書いているのか全くわからないとかそういうケースが多い。 前者について、 swagger はアノテーションでドキュメントを書けるので違いは起きづらくなる。（ それでも不足だが自分でライブラリ作って補った ） また後者に関していえば、swagger は API の仕様を記述するためのフォーマットを提供してくれる。 つまり、s
Swaggerとは何か？ - プログラマでありたい
最近、Swaggerという単語を聞く機会が増えていませんか？MicrosoftやGoogle,IBMが、REST APIの記述標準化を目指した「Open API Initiative」という団体を立ち上げ、そのベースをSwaggerを利用するということで一躍注目を集めるようになりました。しかし、Swaggerというものを調べるとツールの話やドキュメントの話が出てきて、何なのこれとなることが必定です。ということで、WebAPIとは切っても切れない関係のSwaggerの話を簡単にしてみます。 Swaggerとは？ Swaggerとは、一義的にはREST APIを記述する為の仕様です。当初から、Swaggerが標準の仕様になることを目指しますよと宣言していて、米国等ではデファクト・スタンダードとなっていました。それが、「Open API Initiative」が出来たことにより、実際に標準の仕様
RESTful Hypermedia API 概要編 | DevelopersIO
モバイルアプリサービス部の五十嵐です。 最近『ハイパーメディアAPI』という言葉を知って、興味が湧いたので調べてみました。これから何回かに分けて、ハイパーメディアAPIとは何か、Ruby on Railsでのサーバ側の実装方法、クライアント側の実装方法などを紹介していきたいと思います。 1回目の本記事では、ハイパーメディアAPIの概要説明として、用語の説明や登場の背景、フォーマットなどを紹介していきます。特に注意がない限りAPIはWeb APIを指します。なお、用語の定義というのは往々にして議論の対象になりやすいですが、ここでで説明するのは厳密な定義ではなく広義の定義と捉えてください。それでも私の認識に誤りがある場合は、そっとご指摘いただけると幸いです。 用語の説明 RESTful APIとは まずはRESTful APIについて簡単におさらいをします。RESTは分散された情報を扱うための
JSON API — A specification for building APIs in JSON
If you’ve ever argued with your team about the way your JSON responses should be formatted, JSON:API can help you stop the bikeshedding and focus on what matters: your application. By following shared conventions, you can increase productivity, take advantage of generalized tooling and best practices. Clients built around JSON:API are able to take advantage of its features around efficiently cachi
curl を使って Web API をテストする(2)
curl を使って Web API をテストする(2) 2014/7/7 2015/1/29 Linux, UNIX一般, Web 前回は Web APIをテストする時によく使う curl のオプションについて解説しました。 * [curl を使って Web API をテストする(1)](http://lovepeers.org/2014/06/30/curl-web-api/) 今回はよく使うシチュエーションをいくつか挙げて、curl の具体的な使い方を解説します。 ## GETリクエストを送信 一番基本的なGETリクエスト送信。 リダイレクトが発生することを考慮して、”-L” オプションを付けておくと良いでしょう。 curl -L http://api.examples.com/ レスポンスヘッダも見たい時は、”-i” オプションを付けます。 curl -i -L http://api
炎上botを作ったら火傷した - CARTA TECH BLOG
初めまして、VOYAGE MARKETINGに所属している@pro_shunsukeです。 さて、私は先日社内LT大会で「炎上ジェネレーター」について発表しました。 what is 炎上ジェネレーター https://enjo-generator-black.herokuapp.com/ 簡単に炎上出来る！スゴい！ 使い方はとてもシンプル。セリフに文字を入力するだけです。一瞬で出来上がります。出来上がった画像はTwitterに投稿出来たり、画像をダウンロード出来たりします。 発表当時のSlackはこんな感じでした。 面白い！！！ こんな意見も と言うわけで、この炎上ジェネレーターをAPI化してSlack上から簡単に炎上出来るようにしました！ こんな感じです やったこと 炎上ジェネレーターはクライアントサイドでCanvasを利用して画像処理を行っています。API化を行うに当たって、サーバーサ
Nylas | Email and Calendar APIs
Seamlessly integrate your users’ emails, calendars, and contacts Accelerate product velocity with a single platform to connect to your users’ emails, calendars, and contacts, empowering you to build customizable email and scheduling capabilities. Build email and scheduling workflows faster with Nylas Launch critical features way ahead of schedule by spending less time on email and calendar infrast
全てがJSONになる - ✘╹◡╹✘
TL;DR JSON Schemaを使ってこういうことが実現可能になった。 ダミーAPIサーバの提供 ドキュメントの自動生成 APIクライアントの動的定義 APIサーバのバリデータの動的定義 APIサーバのレスポンスの自動テスト JSON Schemaとは JSON SchemaというのはあるJSONのデータ構造を記述するための方法および書式の仕様で、 JSON SchemaもJSONで記述される。 これを利用すれば、リソースベースの(=RESTfulライクな)APIの仕様が簡便に記述できる。 例えば、我々のAPIはレシピとユーザというリソースを扱っていて、 それぞれCRUDのAPIを備えており、レシピはidとtitleとdescriptionという属性を持つ、 という旨をJSON Schemaで表現できる。 なんで最近ちょっと流行ってんの Mobile First、 Service Or
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
Google Cloud 公式ブログ
Kong - Open-Source API Management and Microservice Management
CloudFrontをかますとキャッシュなしのAPIコールでも速くなるようだ : sonots:blog
はてブAPIでwebサービスを作りたい全ての人に向けて書きました
WebAPIのこれまでとこれから
