--- date: 2024-04-03 12:00:00 description: 最近、FileMaker Cloud環境の開発がいくつか重なり、また、FileMaker Data APIを利用するケースも増えてきたため、タイトルの通り、Claris ID Token生成アプリを開発・公開しました。 title: FileMaker CloudのためのClaris ID Token生成アプリを開発・公開しました updatedDate: 2025-12-17 09:00:00 --- 最近、FileMaker Cloud環境での開発案件が重なり、Data APIを利用する機会が増えてきました。そこで、開発効率を上げるために Claris ID Tokenを簡単に生成できるWebアプリを作成・公開しました。 FileMaker Server環境の場合は、以下のようなcurlコマンドで簡単にセッショントークンが作成できます。 ```shell TOKEN=$(echo -n "ACCOUNT:PASSWORD" | base64) curl --request "POST" \ -H "Authorization: Basic ${TOKEN}" \ -H "Content-Type: application/json" \ -d "{}" \ --include \ "https://xxx.frudens.jp/fmi/data/v2/databases/DATABASE_NAME/sessions" > "$(date "+%Y%m%d_%H%M%S").txt" ``` FileMaker Server 環境でのセッショントークン作成コマンド例 しかし、FileMaker Cloud環境の場合、Amazon CognitoのAPIを呼び出したり、AWS SDKを実装する必要があるため、FileMaker Server環境に比べると実装難易度が高くなります。 ## ヘルプを確認 具体的には、以下のヘルプにAmazon CognitoのAPIを利用するための簡易的なJavaScriptのサンプルが記載されています。 > **外部認証での Claris ID の使用** > > > FileMaker Cloud で FileMaker Data API、FileMaker Admin API または OData API を使用するには、外部 IdP アカウントではなく、Claris ID アカウントを使用して認証する必要があります。 > > > FileMaker Cloud では外部認証に Amazon Cognito を使用します。 > > > Amazon Cognito ではユーザプールを使用してユーザを管理します。サインイン、アイデンティティプロバイダを使用した認証、ユーザディレクトリとユーザプロファイルの管理、およびセキュリティ監視などのサービスを提供します。(Amazon Cognito ユーザプールを参照してください。) [外部認証での Claris ID の使用 | Claris Customer Console ヘルプ](https://help.claris.com/ja/customer-console-help/content/create-fmid-token.html) **Claris ID Tokenを取得するためのサンプル** ```js var authenticationData = { Username : 'ユーザ名', Password : 'パスワード', }; var authenticationDetails = new AmazonCognitoIdentity.AuthenticationDetails(authenticationData); var poolData = { UserPoolId : 'us-west-2_NqkuZcXQY', ClientId :'4l9rvl4mv5es1eep1qe97cautn' }; var userPool = new AmazonCognitoIdentity.CognitoUserPool(poolData); var userData = { Username : 'ユーザ名', Pool : userPool }; var cognitoUser = new AmazonCognitoIdentity.CognitoUser(userData); cognitoUser.authenticateUser(authenticationDetails, { onSuccess: function (result) { var Cognito_access_token = result.getAccessToken().getJwtToken(); var Claris_ID_token = result.idToken.jwtToken; var Claris_ID_refresh_token = result.refreshToken.token; }, onFailure: function(err) { alert(err); }, mfaRequired: function(codeDeliveryDetails) { var verificationCode = prompt('Please input verification code' ,''); cognitoUser.sendMFACode(verificationCode, this); } }); ``` Claris ヘルプに記載されている Amazon Cognito SDK を使用したサンプルコード [Accessing Your User Pools using the Amazon Cognito Identity SDK for JavaScript | Front-End Web & Mobile](https://aws.amazon.com/jp/blogs/mobile/accessing-your-user-pools-using-the-amazon-cognito-identity-sdk-for-javascript/) 一般的なプログラミングを経験している開発者であれば、容易に理解できると思いますが、FileMakerしか使ったことのない開発者の場合は、少し難しいと感じるかもしれません。 また、AWSのJavaScriptのSDKを使うということは、簡易的なHTMLを作成する必要があります。Node.jsやPythonなどのAWS SDKを使用する場合は、それらのランタイム環境やサーバー構築が必要となります。 そこで、Web技術（HTML/JS）やAWSの環境構築に不慣れな開発者の方でも、簡単にClaris ID Tokenを取得できるように、Claris ID Token生成アプリを開発・公開しました。 ## Claris ID Token生成アプリについて 以下のURLにアクセスし、Claris IDとパスワードを入力するだけで、Claris ID Tokenを取得できます。 **ページ下部の動画**で、実際の操作手順や動作の様子をご確認いただけます。 [Generating a Claris ID Token with FileMaker Cloud | frudens Inc.](https://claris-idtoken.frudens.com/) 本アプリは、処理のすべてがクライアントサイド（ブラウザ上）で完結しています。Amazon CognitoへのAPIリクエストを除き、入力された認証情報を外部サーバーへ送信・保存する処理は一切含まれていません。ソースコードは公開しておりますので、エンジニアの方はご自身で安全性を確認していただくことも可能です。 ### 認証フロー図 sequenceDiagram autonumber actor User as ユーザー participant Browser as ブラウザ (Claris ID Token生成アプリ) participant Cognito as Amazon Cognito (us-west-2) Note over Browser, Cognito: ⚠️ サーバーを介さず直接通信 User ->> Browser: メールアドレス / PW 入力 Browser ->> Cognito: InitiateAuth (SRP_A) 認証開始リクエスト Cognito -->> Browser: Challenge (PASSWORD_VERIFIER) パスワード検証要求 Browser ->> Cognito: RespondToAuthChallenge 署名付きレスポンス送信 alt MFA認証が必要な場合 Cognito -->> Browser: Challenge (SMS_MFA) 認証コード要求 Browser ->> User: コード入力プロンプト User ->> Browser: SMSのコードを入力 Browser ->> Cognito: RespondToAuthChallenge 認証コード送信 end Cognito -->> Browser: AuthenticationResult (ID Token, Access Token, Refresh Token) Browser ->> User: トークンとcurlコマンドを表示 認証プロセスのシーケンス図：処理はブラウザとAmazon Cognito間で完結する ### Claris ID Token生成アプリのHTML ソースコードを確認したい場合は、以下をクリックして展開してください。 **ソースコードを表示（index.html）** ```html Generating a Claris ID Token with FileMaker Cloud | frudens Inc. Generating a Claris ID Token with FileMaker Cloud A simple app for generating Claris ID Token with FileMaker Cloud. As this is a client-side process only, we do not collect any information you enter. Please check the source code. **Get Claris ID Token** Email address Enter your email address when signing in to your Claris ID. Password Get Claris ID Token **Refresh Claris ID Token / Global Sign out** Claris ID Token Response Refresh Token [The Claris ID refresh token allows scripts to continue running after the Claris ID token expires, and is valid for one year.](https://help.claris.com/en/customer-console-help/content/create-fmid-token.html) Access Token [The access token is used in the GlobalSignOut method.](https://docs.aws.amazon.com/ja_jp/cognito-user-identity-pools/latest/APIReference/API_GlobalSignOut.html) Claris ID Token [The Claris ID token is used for authentication when you use the FileMaker Data API, FileMaker Admin API, or OData API, and is valid for one hour.](https://help.claris.com/en/customer-console-help/content/create-fmid-token.html) Refresh Claris ID Token Global Sign out **curl Command for FileMaker** Refresh Claris ID Token Copy Global Sign out Copy **API Reference** **Amazon Cognito User Pools - API Reference** - [InitiateAuth - Amazon Cognito User Pools](https://docs.aws.amazon.com/ja_jp/cognito-user-identity-pools/latest/APIReference/API_InitiateAuth.html) - [GlobalSignOut - Amazon Cognito User Pools](https://docs.aws.amazon.com/ja_jp/cognito-user-identity-pools/latest/APIReference/API_GlobalSignOut.html) **Video** **Generating a Claris ID Token with FileMaker Cloud** by [Teruhiro Komaki (frudens Inc.)](https://frudens.jp). // auth const EmailElement = document.getElementById('email'); const PasswordElement = document.getElementById('password'); // token const ClarisIdTokenResponseElement = document.getElementById('clarisIdTokenResponse'); const RefreshTokenElement = document.getElementById('refreshToken'); const AccessTokenElement = document.getElementById('accessToken'); const ClarisIdTokenElement = document.getElementById('clarisIdToken'); // curl const CurlRefreshClarisIdTokenElement = document.getElementById('curlRefreshClarisIdToken'); const CurlGlobalSignOutElement = document.getElementById('curlGlobalSignOut'); const CurlRefreshClarisIdTokenButtonElement = document.getElementById('curlRefreshClarisIdTokenButton'); const CurlGlobalSignOutButtonElement = document.getElementById('curlGlobalSignOutButton'); const POOL_DATA = { UserPoolId: 'us-west-2_NqkuZcXQY', ClientId: '4l9rvl4mv5es1eep1qe97cautn', }; const USER_POOL = new AmazonCognitoIdentity.CognitoUserPool(POOL_DATA); function CustomResponse(ok, data, error, message) { this.ok = ok; this.data = data; this.error = error; this.message = message; } const curlRefreshClarisIdTokenTemplate = (refreshToken) => { return `curl -X 'POST' 'https://cognito-idp.us-west-2.amazonaws.com/' \\ -H 'authority: cognito-idp.us-west-2.amazonaws.com' \\ -H 'content-type: application/x-amz-json-1.1' \\ -H 'x-amz-target: AWSCognitoIdentityProviderService.InitiateAuth' \\ --data-raw '{"ClientId":"${POOL_DATA.ClientId}","AuthFlow":"REFRESH_TOKEN_AUTH","AuthParameters":{"REFRESH_TOKEN":"${refreshToken}","DEVICE_KEY":null}}'`; }; const curlGlobalSignOutTemplate = (accessToken) => { return `curl -X 'POST' 'https://cognito-idp.us-west-2.amazonaws.com/' \\ -H 'authority: cognito-idp.us-west-2.amazonaws.com' \\ -H 'content-type: application/x-amz-json-1.1' \\ -H 'x-amz-target: AWSCognitoIdentityProviderService.GlobalSignOut' \\ --data-raw '{"AccessToken":"${accessToken}"}'`; }; function clearElement() { // clear token ClarisIdTokenResponseElement.value = ''; RefreshTokenElement.value = ''; AccessTokenElement.value = ''; ClarisIdTokenElement.value = ''; // clear curl command CurlRefreshClarisIdTokenElement.value = ''; CurlGlobalSignOutElement.value = ''; } function copy(element) { if (element === CurlRefreshClarisIdTokenButtonElement) { navigator.clipboard.writeText(CurlRefreshClarisIdTokenElement.value); } else if (element === CurlGlobalSignOutButtonElement) { navigator.clipboard.writeText(CurlGlobalSignOutElement.value); } } async function getClarisIdToken() { console.log('getClarisIdToken'); try { const authenticationData = { Username: EmailElement.value, Password: PasswordElement.value, }; const authenticationDetails = new AmazonCognitoIdentity.AuthenticationDetails(authenticationData); const userData = { Username: EmailElement.value, Pool: USER_POOL, }; const cognitoUser = new AmazonCognitoIdentity.CognitoUser(userData); await cognitoUser.authenticateUser(authenticationDetails, { onSuccess: function(result) { console.log('onSuccess'); console.log('result'); console.log(result); // update token ClarisIdTokenResponseElement.value = JSON.stringify(result); const refreshToken = result.refreshToken.token; const accessToken = result.accessToken.jwtToken; RefreshTokenElement.value = refreshToken; AccessTokenElement.value = accessToken; ClarisIdTokenElement.value = result.idToken.jwtToken; // update curl command CurlRefreshClarisIdTokenElement.value = curlRefreshClarisIdTokenTemplate(refreshToken); CurlGlobalSignOutElement.value = curlGlobalSignOutTemplate(accessToken); return new CustomResponse(true, result, null, null); }, onFailure: function(e) { console.error('onFailure'); console.error(e); clearElement(); // update response ClarisIdTokenResponseElement.value = JSON.stringify(e); return new CustomResponse(false, null, e, e.message); }, mfaRequired: function(codeDeliveryDetails) { console.log('mfaRequired'); const verificationCode = window.prompt('Please input verification code', ''); cognitoUser.sendMFACode(verificationCode, this); }, }); } catch (e) { console.error(e); clearElement(); // update response ClarisIdTokenResponseElement.value = JSON.stringify(e); return new CustomResponse(false, null, e, 'An unexpected error has occurred'); } } async function refreshClarisIdToken() { console.log('refreshClarisIdToken'); try { const refreshToken = RefreshTokenElement.value; const body = { 'ClientId': POOL_DATA.ClientId, 'AuthFlow': 'REFRESH_TOKEN_AUTH', 'AuthParameters': { 'REFRESH_TOKEN': refreshToken, 'DEVICE_KEY': null, }, }; const url = new URL(`https://cognito-idp.us-west-2.amazonaws.com/`); const res = await fetch(url, { method: 'POST', headers: { authority: 'cognito-idp.us-west-2.amazonaws.com', 'content-type': 'application/x-amz-json-1.1', 'x-amz-target': 'AWSCognitoIdentityProviderService.InitiateAuth', }, body: JSON.stringify(body), }); const refreshResponse = await res.json(); console.log('refreshResponse'); console.log(refreshResponse); if (res.status !== 200) { // clear token ClarisIdTokenResponseElement.value = JSON.stringify(refreshResponse); AccessTokenElement.value = ''; ClarisIdTokenElement.value = ''; // clear curl command CurlGlobalSignOutElement.value = ''; } else { // update token ClarisIdTokenResponseElement.value = JSON.stringify(refreshResponse); const accessToken = refreshResponse.AuthenticationResult.AccessToken; AccessTokenElement.value = accessToken; ClarisIdTokenElement.value = refreshResponse.AuthenticationResult.IdToken; // update curl command CurlGlobalSignOutElement.value = curlGlobalSignOutTemplate(accessToken); } return new CustomResponse(true, refreshResponse, null, null); } catch (e) { console.error(e); // clear token ClarisIdTokenResponseElement.value = JSON.stringify(e); AccessTokenElement.value = ''; ClarisIdTokenElement.value = ''; // clear curl command CurlGlobalSignOutElement.value = ''; return new CustomResponse(false, null, e, 'An unexpected error has occurred'); } } async function globalSignOut() { console.log('globalSignOut'); try { const accessToken = AccessTokenElement.value; const body = { 'AccessToken': accessToken, }; const url = new URL(`https://cognito-idp.us-west-2.amazonaws.com/`); const res = await fetch(url, { method: 'POST', headers: { authority: 'cognito-idp.us-west-2.amazonaws.com', 'content-type': 'application/x-amz-json-1.1', 'x-amz-target': 'AWSCognitoIdentityProviderService.GlobalSignOut', }, body: JSON.stringify(body), }); const signOutResponse = await res.json(); console.log('signOutResponse'); console.log(signOutResponse); return new CustomResponse(true, signOutResponse, null, null); } catch (e) { console.error(e); return new CustomResponse(false, null, e, 'An unexpected error has occurred'); } } ``` Claris ID Token生成アプリの全ソースコード（index.html） ## Claris ID Tokenに関するよくある誤解 Claris ID Tokenについて調べると、`以下のような課題がある`といった記事を見かけることがありますが、実際にはこれらの課題は解決可能です。 古いコードを元に作業をされたり、Amazon CognitoのAPIを見ていないことが原因です。 - MFA認証（SMSで通知されるコード）に対応していないと誤解されている。 - トークン更新時にもSDKが必須となり、FileMakerからは扱いづらいと思われている。 Claris ID Token生成アプリ内にも、Claris ID Tokenを更新するための、curlオプションを表示するようにしました。 つまり、Claris ID Refresh Tokenの初回取得時は、手動で取得作業が必要になりますが、取得した Claris ID Refresh Tokenが有効な1年間の間は、FileMakerの**「URL から挿入」スクリプトステップ**のcURLオプションを利用して、Claris ID Tokenを更新し続けることができます。 現在、Claris ID Tokenの仕組みや関連用語（アクセストークン、リフレッシュトークン等）を詳しく解説する記事も執筆中です。公開まで今しばらくお待ちください。