移行前
移行を始める前に、ルールからActionsへの移行を参照してください。この移行ガイドでは、ルールとActionsの違いをわかりやすく説明しており、移行を進める際に役立ちます。ルールの移行順序
ルールは Actions より前に実行されるため、ルールは実行順の逆順で移行する必要があります。既存のフローで最後に実行される ルール から移行を始め、そこから時系列をさかのぼって最初の ルール へ進めてください。 この順序で移行しないと、ルール と Actions の実行順における依存関係によって予期しない副作用が生じ、エラーが発生する可能性があります。安全にロールバックする
移行ツールを使えば、問題が発生しても安全かつ簡単にロールバックできます。ルール を再度有効にし、対応する Action のロジックはスキップしてください。ルール の移行
ルール の移行を開始するには、Auth Pipeline > Rules を選択します。選択すると、ルールが表示され、各ルールを個別に移行するためのオプションが表示されます。
Migrate to Action を選択しても、その時点では移行が開始されるだけです。新しい Action をいつ有効化するかは、開発者が選べます。
Migrate to Action
Migrate to Action を選択すると、ツールで新しい Action を作成するよう求められます。
api.rules.wasExecuted() を呼び出すことで実現されます。wasExecuted 関数にルール ID を含む文字列を渡すと、そのルールがすでに実行されている場合は true を返し、そうでない場合は false を返します。
これにより、ロジックが二重に実行されるのを防げます。参照先のルールを無効にすると、この関数は false を返すようになり、以降は Action 内でビジネスロジックが実行されます。
ルール ID の値は、Migrate to Action 機能を使って移行されたすべてのルールに対して自動的に設定されます。
api.rules.wasExecuted() 関数の詳細については、Actions Triggers: post-login - API Object を参照してください。
Rule のコードを書き換える
Actions Editor で ルール ボタンを選択し、ルール移行ツールを開きます。ここでは、移行された Rule のコードをすぐに参照できます。サイドバーで、選択した Rule のコードを確認してください。 Rule 関数の内容をコピーし、Action の// YOUR CODE HERE コメントの下に貼り付けます。このコードは、Actions のプログラミングモデルに対応していない可能性があります。
callback 関数では、エラー時には api.access.deny を使用し、成功時には return することが推奨されます。
新しいActionをテストする
Actions は、移行作業において重要な要素であるため、エディター内で直接テストできます。詳しくは、Actions をテストするを参照してください。Action を自動的に有効化する
Action のコードを更新し、切り替える準備ができたら:- Deploy を選択します。
- デプロイ完了を確認するアラートで、Add to flow を選択します。
- 新しく作成した Action をフローに追加し、Apply を選択します。
- Continue を選択し、選択されているルールを無効化 すると、新しい Action を有効にし、元の ルール を同時に無効化できます。まだ準備ができていない場合は、Cancel を選択してください。ルール は後で無効化して、移行した Action ロジックを有効にすることもできます。
ルール を再度有効にすると、対応する Action ロジックはスキップされます。