Orientação gerada a partir de informações públicas. Apenas para referência.
Um pacote Flutter projetado para simplificar a autenticação de Identidade na Internet (ICP) em aplicativos. Permite integração fluida com o serviço de Identidade na Internet, permitindo que os usuários se autentiquem usando identidades descentralizadas sem senhas. O pacote gerencia todo o fluxo de autenticação, incluindo login, gerenciamento de sessão e verificação de identidade, enquanto oferece suporte a plataformas Android e iOS. Criado para desenvolvedores trabalhando com Web3, simplifica o acesso seguro a aplicativos baseados em blockchain.
Casos de uso
login de aplicativo descentralizado
autenticação de usuário Web3
Gerenciamento de identidade impulsionado por blockchain
Acesso seguro à carteira móvel
Integração de DApp com ICP
Persistência de sessão do usuário
Principais recursos
Fluxo de autenticação ICP automatizado
Suporte multiplataforma (Android e iOS)
Integração com o serviço de Identidade na Internet
Manuseio seguro de token
Código mínimo de boilerplate
Gerenciamento de sessão embutido
Indicado para
Desenvolvedores Flutter construindo DApps
Criadores de aplicativos Web3 e blockchain
Aplicativos móveis que exigem login sem senha
Projetos usando Internet Identity
Equipes focadas em identidade descentralizada
Considerações
Requer configuração de backend da Identidade na Internet
Limitado ao ecossistema ICP
Dependente do fluxo de autenticação baseado em navegador
Pode ser necessário ajustes personalizados na interface
Não adequado para projetos de blockchain não-ICP
README original
Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.
flutter_icp_auth:
This Flutter package simplifies integrating ICP internet identity authentication flow within your Flutter application.
✨ Features
LOG IN: Enables users to log in using internet identity.
AUTO LOGIN: Allows users to log in automatically.
RELOAD: Automatically logs in users when the app is reloaded or opened, based on session data/delegationObject.
LOGOUT: Provides functionality for users to log out.
⚠️ Important Info
1. isLocal is used to denote whether you are running your application using mainnet links or locally.
Change the bool value based on your apps requirement.
If isLocal is true then replace the values of backendCanisterId and middlePageCanisterId with the locally deployed canister ids.
If isLocal is false then replace the values of backendCanisterId and middlePageCanisterId with the main-net deployed canister ids.
2. For local or main-net backendCanisterId make sure you have the following function in your backend:
Rust:
use ic_cdk::api::caller;
#[ic_cdk::query]fnwhoami() ->String {
letprincipal_id = caller().to_string();
format!("principal id - : {:?}", principal_id)
}
Motoko:
import Principal "mo:base/Principal";
actor {
public shared (msg) func whoami() : async Text {
Principal.toText(msg.caller);
};
};
For main-net you can use our canisterId as well: cni7b-uaaaa-aaaag-qc6ra-cai
3. For local or main-net middlePageCanisterId make sure you have the following:
Local:
Clone the repo from here and deploy locally: https://github.com/ICP-hub/flutter_icp_auth_middleware
Main-net:
a. You can deploy the cloned middlePage to main net and use the main net canister id.
OR
b. You can use our main-net id as well: nplfj-4yaaa-aaaag-qjucq-cai
4. For IDL and Services:
You can use candid_dart to generate the did files and the IDL services and then use them in the app as demonstrated in the example app.
OR
You can add/write the file or code manually and then use them accordingly.
Open android → app → src → main → AndroidManifest.XML, , add the following snippet, and replace android:scheme and android:host with your app's values:
bool isLocal =
false; // To confirm if you running your project locally or using main-net. Change it to true if running locallyService idlService =
FieldsMethod.idl; // Idl service (Location: lib/integration.dart)String backendCanisterId =
'cni7b-uaaaa-aaaag-qc6ra-cai'; // Replace it with your backend canisterIdString middlePageCanisterId =
'nplfj-4yaaa-aaaag-qjucq-cai'; // Replace it with your middlePage canisterId
isLoggedIn and _principalId are used to change the state of the log in/log out button and principal text. You can modify them according to your applications need.
Future<void> _manualLogin(Uri uri) async {
List<dynamic> result = awaitAuthLogIn.fetchAgent(
uri.queryParameters, isLocal, backendCanisterId, idlService);
if (result.isNotEmpty) {
setState(() {
isLoggedIn = uri.queryParameters['status'] == "true" ? true : false;
_principalId = result[0];
});
} else {
setState(() {
isLoggedIn = false;
_principalId = "Log in to see your principal";
});
}
}
3. Using the IIDLogin Button
When passing argument in the IIDLogin button, remember to pass your app:host and app:callback:
For login button call:
Replace the argument host and scheme with your app's host and scheme