Rainbow logo
RainbowKit
2.2.5

自訂身份驗證

自訂身份驗證

連接到你自己的身份驗證後端

雖然 RainbowKit 提供完善的 用 Ethereum 和 NextAuth 登入的支持, 你亦可以配合自定後端和訊息格式進行整合。

首先建立一個身份驗證適配器。 這樣 RainbowKit 就可以創建/準備消息並與你的後端通信。

例如,我們可以製作一個認證適配器,讓我們可以使用 用 Ethereum 登入 對接一些自定 API 終端,如 iron-session

import { createAuthenticationAdapter } from '@rainbow-me/rainbowkit';
import { createSiweMessage } from 'viem/siwe';
const authenticationAdapter = createAuthenticationAdapter({
getNonce: async () => {
const response = await fetch('/api/nonce');
return await response.text();
},
createMessage: ({ nonce, address, chainId }) => {
return createSiweMessage({
domain: window.location.host,
address,
statement: 'Sign in with Ethereum to the app.',
uri: window.location.origin,
version: '1',
chainId,
nonce,
});
},
verify: async ({ message, signature }) => {
const verifyRes = await fetch('/api/verify', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ message, signature }),
});
return Boolean(verifyRes.ok);
},
signOut: async () => {
await fetch('/api/logout');
},
});

假設你的應用已經某種方式管理身份驗證生命周期,你可以將當前的身份驗證狀態與你的自訂適配器一起傳遞給 RainbowKitAuthenticationProvider,封裝你現有的 RainbowKitProvider

import { createAuthenticationAdapter, RainbowKitAuthenticationProvider, RainbowKitProvider, } from '@rainbow-me/rainbowkit';
import { AppProps } from 'next/app';
import { WagmiProvider } from 'wagmi';
import { QueryClientProvider, QueryClient, } from "@tanstack/react-query";
const authenticationAdapter = createAuthenticationAdapter({
/* See above... */
});
const queryClient = new QueryClient();
export default function App({ Component, pageProps }: AppProps) {
// You'll need to resolve AUTHENTICATION_STATUS here
// using your application's authentication system.
// It needs to be either 'loading' (during initial load),
// 'unauthenticated' or 'authenticated'.
return (
<WagmiProvider {...etc}>
<QueryClientProvider client={queryClient}>
<RainbowKitAuthenticationProvider adapter={authenticationAdapter} status={AUTHENTICATION_STATUS} >
<RainbowKitProvider {...etc}>
<Component {...pageProps} />
</RainbowKitProvider>
</RainbowKitAuthenticationProvider>
</QueryClientProvider>
</WagmiProvider>
);
}

如果你已經到這一步並為現有的開源身份驗證庫創建了適配器,請考慮創建一個包讓其他人使用!