重要なお知らせ！Catalyst認証の変更点

継続的かつ一貫した評価を経て、Catalystチームは認証のいくつかの側面を改善し、実装を容易にしながら、アプリケーション全体のセキュリティを強化しました。

ロール設定の変更

これまで、Catalyst Web SDKを使用してアプリケーションにエンドユーザー認証を実装していた場合、特定のRole IDを渡すことで、各ユーザーが追加されるロールを設定するオプションがありました。

しかし今後は、Web SDKを介したエンドユーザー認証によるサインアップ時に渡されるロールはすべて無視されます。ユーザーがアプリケーションにサインアップすると、デフォルトのApp Userロール、またはUser Managementセクションで設定した他のデフォルトロールに追加されます。設定されたデフォルトロール以外の特定のロールにユーザーを追加する必要がある場合は、Custom User Validation機能を使用できます。

Embedded Authenticationの機能強化

CatalystのEmbedded Authenticationを最大限に活用し続けるためには、以下の手順に従い、お使いのCatalystプロジェクトに適用する必要があります。

以下の内容をよくお読みいただき、必要に応じて適用してください：

• Embedded Authenticationを使用してアプリケーションにユーザーを追加するために、Catalyst Web SDKの以前のバージョンを使用している場合は、Web SDK v4にアップグレードし、Embedded Authenticationのセットアップを適宜再設定する必要があります。

• 必要なWeb SDK v4のスクリプトにアクセスするには：

  • Cloud ScaleサービスのAuthenticationコンポーネントに移動します。Native Catalyst Authenticationの下にあるSet Upをクリックします。
    
  • Embedded Authenticationを選択し、Nextをクリックします。
    
  • Versionドロップダウンでv4を選択し、必要なコードをコピーします。
    
  注意: コードスニペットはこちらのヘルプページでも確認できます。
  • Web SDK v4にアップグレードすると、エンドユーザーにMicrosoft 365、Facebook、またはLinkedInアカウントを使用してアプリケーションにログインするオプションを提供できるようになります。既存のZohoおよびGoogleソーシャルログインオプションも引き続き利用可能です。さらに、新しいバージョンでは、ログイン要素のスタイリングやカスタマイズをより細かく制御しながら、シームレスにユーザーを追加できます。
    

• 2025年3月31日をもって、Catalyst Web SDKの以前のバージョンはすべて動作しなくなります。この期限までにWeb SDK v4へのアップグレードと関連する設定を完了することを強くお勧めします。以下の画像は、埋め込みログイン要素の新しいデフォルトUIの外観を示しています。このページのCSSは、こちらのヘルプページからダウンロードできるCSSスクリプトを使用してカスタマイズできます。
  上記の期限を過ぎても古いSDKバージョンを使用し続けると、Embedded Authentication要素のデザインに使用されているCSS要素が意図した通りに機能せず、UIの予期しない表示崩れが発生します。
  

• Googleソーシャルログインの実装サポートはWeb SDK v3から存在しています。ただし、Web SDK v4にアップグレードする場合は、redirect URLsを適宜再設定する必要があります。Googleソーシャルログインの設定手順はこちらをご確認ください。
  

詳細やサポートが必要な場合は、サポートチーム（support@zohocatalyst.com）までお問い合わせください。

Happy Coding!

Team Catalyst