はじめに
認証をつけた状態でReactのクライアントから GraphQL API を使うときに簡単に実現する方法を書いてみました。認証ページでサインアップ、ログイン、トークンを使ってGraphQL APIにリクエストまで完了します。
React の開発環境の構築
$ npm install -g create-react-app
$ create-react-app amplify-sample
create-react-app でプロジェクトのベースとなる部分を生成します。
デフォルトのプロジェクトが作成されたら、動作確認をしてみます。
$ cd amplify-sample
$ yarn start
これでローカルにnodeサーバーが立ち上がり http://localhost:3000/ で動作確認をできるようになります。
AWS Amplify のインストールと AWS へのアクセス設定
amplify の設定のタイミングでこのアプリケーション用に権限が払い出されます。これを実行する前に、ブラウザで AWS にログインしておきます。regionは今回tokyo (ap-northeast-1) を選択します。
amplify : https://aws-amplify.github.io/amplify-js/media/quick_start?platform=purejs
$ npm install -g @aws-amplify/cli
$ amplify configure
username を選択したあとブラウザで AWS 画面が開かれます。アプリからAWS にアクセスするための権限を払い出します。今回はサンプルなので一旦強めの権限でアカウントを払い出します。デフォルトのまま進めると Admin 権限のユーザーが払い出されます。
AWS のアプリ用権限の払い出しと、access key の設定。
ユーザーが作成されると、CLIでaccessKey、secretAccesKeyがブラウザ上で表示されます。amplify cliにこれらのkeyを入力します。
今回作成したユーザーはadmin権限がついているはずですので、githubなどに公開してしまうと他人にadmin権限を渡すことになります。他人には見せないようキーの扱いには注意が必要です。
amplify cli を使って AWS の環境を構築
$ amplify init
$ amplify push
以上で。AWS のバックエンドを操作する準備と、AWS への接続準備が完了しました。最終的にamplify pushにより src/aws-exports.js というファイルが作成されるのがゴールになります。aws-exports.js には接続先情報が記載されており、このファイルさえあれば aws への接続は可能です。AWS 環境を自分で構築して、aws-exports.js を自分で書いてしまえば amplify cli の作業は必要ありません。
amplify cli の詳細はこちら
https://github.com/aws-amplify/amplify-cli
aws-exports.js の中身
import Amplify from 'aws-amplify';
Amplify.configure({
Auth: {
// REQUIRED - Amazon Cognito Identity Pool ID
identityPoolId: 'XX-XXXX-X:XXXXXXXX-XXXX-1234-abcd-1234567890ab',
// REQUIRED - Amazon Cognito Region
region: 'XX-XXXX-X',
// OPTIONAL - Amazon Cognito User Pool ID
userPoolId: 'XX-XXXX-X_abcd1234',
// OPTIONAL - Amazon Cognito Web Client ID
userPoolWebClientId: 'XX-XXXX-X_abcd1234',
}
});
AWS AppSync バックエンドの構築
amplify-cli を利用して マネージド GraphQL サービスである AWS AppSyncの環境を構築します。
AppSync 公式 : https://aws.amazon.com/jp/appsync/
AppSync 説明資料 : https://www.slideshare.net/keisuketsukagoshi/rest-api-graphql
$ amplify add api
途中、data typeを新しく作るか聞かれるので新しいtypeを定義しましょう。
type City @model {
id: ID!
name: String!
description: String
location: String
}
$ amplify push
以上で、GraphQL のエンドポイントの構築が完了しました。実際にできているものを確認するためにAppSyncのコンソールをブラウザでひらいてみます。先ほど定義した data type のスキーマが出来上がっているのが確認できます。
実際に GraphQL の動作を確認してみます。Query の画面を開いて、定義されている Operation をここで試すことができます。どんな Operation が定義されているかは
データの追加とデータの取得を何パターンか試してみます。
データの追加
mutation create {
createCity(input:{
name:"fukuoka"
description:"nice food"
}){
id name description
}
}
データの取得
query list {
listCitys{
items{
id name description
}
}
}
データのフィルター
query filter {
listCitys(filter:{
description:{
contains:"food"
}
}){
items{
id name description
}
}
}
クライアントから Amplify を使って AppSync に接続
コンソールでプロジェクトのトップにいき、amplify-js のライブラリを追加します。
$ yarn add aws-amplify aws-amplify-react
index.js にamplifyの設定を組み込みます。aws-exportsに接続先情報が格納されています。
...省略...
import Amplify from "aws-amplify";
import config from "./aws-exports";
Amplify.configure(config)
...省略...
App.js を編集してさっき作成したGraphQL endpointを叩いてみます。component が読み込まれたタイミングでgraphqlのAPIをたたいて、結果を console.log に出力するだけのコードになっています。
データの取得
...省略...
import { API, graphqlOperation } from "aws-amplify";
const ListCities = `
query list {
listCitys {
items{
id name description
}
}
}
`;
class App extends Component {
async componentDidMount() {
const cities = await API.graphql(graphqlOperation(ListCities))
console.log('cities:', cities)
}
...省略...
ブラウザで consoleを開いてもらうとデータが取得できているのが確認できます。
次に、取得できた値を画面に表示してみます。
...省略...
class App extends Component {
state = {cities: []}
async componentDidMount() {
const cities = await API.graphql(graphqlOperation(ListCities))
console.log('cities:', cities)
this.setState({cities: cities.data.listCitys.items})
}
render() {
return (
<div className="App">
{
this.state.cities.map((content, index) => (
<div key={index}>
<h3>{content.name}</h3>
<p>{content.description}</p>
</div>
))
}
</div>
);
}
...省略...
以上で、データの取得は完了です。
データの更新と購読を実装
データの更新
graphQLのオペレーションを書きます。List の時と同じような内容ですが、mutationの場合パラメーターがはいるのでそちらに注意する必要があります。App.js を編集します。
...省略...
const CreateCity = `
mutation($name: String!, $description: String) {
createCity(input:{
name:$name
description:$description
}){
id name description
}
}
`
...省略...
App Component に入力フィールドと graphQL を叩く部分を実装します。ここも API.graphql の第２引数にパラメーターをセットします。
...省略...
class App extends Component {
state = {cities: [], name:"", description:""}
async componentDidMount() {
...省略...
}
onChange = e => {
this.setState({[e.target.name] : e.target.value})
}
//ここが graphQL を叩く部分
createCity = async() => {
if ((this.state.name === '') || (this.state.description === '')) return
const city = {name: this.state.name, description: this.state.description}
try {
const cities = [...this.state.cities, city]
this.setState({cities, name:"", description:""})
await API.graphql(graphqlOperation(CreateCity, city))
console.log('success')
} catch (error) {
console.log('error: ', error)
}
}
render() {
return (
<div className="App">
<div>
<input value={this.state.name} name="name" onChange={this.onChange} />
<input value={this.state.description} name="description" onChange={this.onChange} />
<button onClick={this.createCity}>Create City</button>
</div>
...省略...
データの購読
graphQL のオペレーションを作成します。
const SubscribeToCities = `
subscription {
onCreateCity {
id name description
}
}
`;
Listと同じようにMountされたタイミングで購読を開始します。
...省略...
async componentDidMount() {
const cities = await API.graphql(graphqlOperation(ListCities))
console.log('cities:', cities)
this.setState({cities: cities.data.listCitys.items})
//Cityが作られたイベントを購読
API.graphql(
graphqlOperation(SubscribeToCities)
).subscribe({
next: (eventData) => console.log('eventData: ', eventData)
});
}
...省略...
購読しているデータに更新があった場合に、Stateを更新するよう修正。これにより更新をリアルタイムで画面に表示することが可能になります。
...省略...
//Cityが作られたイベントを購読
API.graphql(
graphqlOperation(SubscribeToCities)
).subscribe({
next: (eventData) => {
const city = eventData.value.data.onCreateCity
const cities = [...this.state.cities.filter(content => {
return ((content.name !== city.name) && (content.description !== city.description))
}), city]
console.log('eventData : ', eventData)
this.setState({cities})
}
});
...省略...
以上で、Query / Mutation / Subscription のすべての実装が完了しました。
認証機能の追加
Amazon Cognito という認証サービスを利用して認証機能を追加していきます。
https://aws.amazon.com/jp/cognito/
ターミナルから amplify cli を使ってcognitoを作成します。amplify add authの後に設定をきかれますが、今回は default configuration を使います。
$ amplify add auth
$ amplify push
ブラウザでcognitoのマネージメントコンソールを確認すると新たにユーザープールができていることが確認できます。
これで認証のバックエンドの準備が完了しました。ソースコードを修正して、認証していない場合はログインページを表示するという実装をおこないます。amplify にはHOCでAuthenticatorが準備されているため、これを利用します。
App.jsを変更していきます。export default Appを 以下のように変更します。
import { withAuthenticator } from "aws-amplify-react";
... 省略 ...
export default withAuthenticator(App, {includeGreeting: true});
これで、認証していない場合はログインページが表示され、ログインしていると最初のページが表示されるようになりました。
ここまでで、認証機能の実装とAppSyncへのリクエストがそれぞれ完了しています。ただ、AppSyncは現状API Keyでのリクエストになっており、この認証と連動していません。最後に認証ユーザーのみを許可するような形にAppSyncを修正していきます。
AppSyncを未認証では接続できないよう修正
amplify-cli で AppSyncを更新します。authorization typeをCognito User Poolで選択します。これにより先ほど設定したUser Pool で認証するよう AppSync を更新します。
$ amplify update api
? Please select from one of the below mentioned services GraphQL
? Choose an authorization type for the API Amazon Cognito User Pool
確認のため、SignOut をします。さらに未認証状態で叩けることを確認すうために App.js から withAuthenticator を外します。
// export default withAuthenticator(App, {includeGreeting: true});
export default App;
この状態でブラウザを開くとデータがとってこれていないことが確認できます。
最後に withAuthenticatorに戻して終了です。
免責
本投稿は、個人の意見で、所属する企業や団体は関係ありません。
また掲載しているsampleプログラムの動作に関しても保障いたしませんので、参考程度にしてください。