Lägga till registrering i intern iOS/macOS-app - Microsoft identity platform

Artikel
03/05/2025

Gäller för: vit cirkel med en grå X-symbol. anställdas hyresgäster grön cirkel med en vit bock. externa hyresgäster (läs mer)

Den här självstudien visar hur du registrerar en användare med e-postlösenord eller användarnamn (e-post) och lösenord och samlar in användarattribut i din iOS/macOS-app med inbyggd autentisering.

Registrera en användare med ett engångslösenord via e-post eller ett användarnamn (e-post) och lösenord.
Samla in användarattribut under registreringen.
Hantera registreringsfel.

Förutsättningar

Självstudie: Förbered din iOS/macOS-app för intern autentisering.
Om du vill samla in användarattribut under registreringen konfigurerar du användarattributen när du skapa ditt användarflöde för registrering och inloggning.

Om du vill registrera en användare med e-postlösenord eller användarnamn (e-post) och lösenord samlar du in ett e-postmeddelande från användaren och skickar sedan ett e-postmeddelande med ett engångslösenord till användaren. Användaren anger ett giltigt engångslösenord för e-post för att verifiera sitt användarnamn.

Om du vill registrera en användare måste du:

Skapa ett användargränssnitt (UI) för att:
- Samla in ett e-postmeddelande från användaren. Lägg till validering i dina indata för att se till att användaren anger en giltig e-postadress.
- Samla in ett lösenord om du registrerar dig med användarnamn (e-post) och lösenord.
- Samla in ett engångslösenord för e-post från användaren.
- Samla in användarattribut om det behövs.
- Skicka om engångslösenordet om användaren inte tar emot det.
- Starta registreringsflödet.
I din app lägger du till en knapp vars select-händelse utlöser följande kodfragment:
```
@IBAction func signUpPressed(_: Any) {
    guard let email = emailTextField.text else {
        resultTextView.text = "Email or password not set"
        return
    }

    let parameters = MSALNativeAuthSignUpParameters(username: email)
    nativeAuth.signUp(parameters: parameters, delegate: self)
}
```
- Om du vill registrera en användare med hjälp av E-post engångslösenordanvänder vi bibliotekets signUp(parameters:delegate)-metod, som svarar asynkront genom att anropa någon av metoderna för det skickade ombudsobjektet, som måste implementera SignUpStartDelegate-protokollet. Följande kodrad initierar registreringsprocessen för användare:
```
nativeAuth.signUp(parameters: parameters, delegate: self)
```
  I metoden signUp(parameters:delegate) skickar vi en MSALNativeAuthSignUpParameters-instans som innehåller användarens e-postadress från överföringsformuläret tillsammans med ombudet (en klass som implementerar SignUpStartDelegate-protokollet).
- Om du vill registrera en användare med e-post med lösenordanvänder du följande kodfragment:
```
@IBAction func signUpPressed(_: Any) {
    guard let email = emailTextField.text, let password = passwordTextField.text else {
       resultTextView.text = "Email or password not set"
       return
    }

    let parameters = MSALNativeAuthSignUpParameters(username: email)
    parameters.password = password
    nativeAuth.signUp(parameters: parameters, delegate: self)
}
```
  Vi använder bibliotekets signUp(parameters:delegate)-metod, som svarar asynkront genom att anropa någon av metoderna för det skickade delegatobjektet, som måste implementera SignUpStartDelegate-protokollet. Följande kodrad initierar registreringsprocessen för användare:
```
nativeAuth.signUp(parameters: parameters, delegate: self)
```
  I metoden signUp(parameters:delegate) skickar vi en MSALNativeAuthSignUpParameters-instans som innehåller användarens e-postadress och deras lösenord tillsammans med ombudet (en klass som implementerar SignUpStartDelegate-protokollet).
- Om du vill implementera SignUpStartDelegate protokoll som ett tillägg till vår klass använder du:
```
extension ViewController: SignUpStartDelegate {
    func onSignUpStartError(error: MSAL.SignUpStartError) {
        resultTextView.text = "Error signing up: \(error.errorDescription ?? "no description")"
    }

    func onSignUpCodeRequired(
        newState: MSAL.SignUpCodeRequiredState,
        sentTo: String,
        channelTargetType: MSAL.MSALNativeAuthChannelType,
        codeLength: Int
    ) {
        resultTextView.text = "Verification code sent to \(sentTo)"
    }
}
```
  Anropet till signUp(parameters:delegate)resulterar i ett anrop till antingen onSignUpCodeRequired() eller onSignUpStartError() delegeringsmetoder. onSignUpCodeRequired(newState:sentTo:channelTargetType:codeLength) anropas för att ange att en kod har skickats för att verifiera användarens e-postadress. Tillsammans med viss information om var koden har skickats och hur många siffror den innehåller, har den här delegatmetoden också en newState parameter av typen SignUpCodeRequiredState, vilket ger oss åtkomst till två nya metoder:
  - submitCode(code:delegate)
  - resendCode(delegate)
  Om du vill skicka koden som användaren har angett för oss använder du:
```
newState.submitCode(code: userSuppliedCode, delegate: self)
```
  - Om du vill implementera SignUpVerifyCodeDelegate protokoll som ett tillägg till vår klass använder du:
```
extension ViewController: SignUpVerifyCodeDelegate {
    func onSignUpVerifyCodeError(error: MSAL.VerifyCodeError, newState: MSAL.SignUpCodeRequiredState?) {
        resultTextView.text = "Error verifying code: \(error.errorDescription ?? "no description")"
    }

    func onSignUpCompleted(newState: SignInAfterSignUpState) {
        resultTextView.text = "Signed up successfully!"
    }
}
```
    submitCode(code:delegate) accepterar en delegatparameter och vi måste implementera de metoder som krävs i protokollet SignUpVerifyCodeDelegate. I det vanligaste scenariot får vi ett anrop till onSignUpCompleted(newState) som anger att användaren har registrerats och att flödet är klart.

Oavsett om du registrerar en användare med e-postlösenord eller användarnamn (e-post) och lösenord kan du samla in användarattribut innan ett användarkonto skapas. Metoden signUp(parameters:delegate) kan anropas med hjälp av en MSALNativeAuthSignUpParameters som har en attributegenskap.

Om du vill samla in användarattribut använder du följande kodfragment:
```
let attributes = [
    "country": "United States",
    "city": "Redmond"
]

let parameters = MSALNativeAuthSignUpParameters(username: email)
parameters.password = password
parameters.attributes = attributes
nativeAuth.signUp(parameters: parameters, delegate: self)
```
signUp(parameters:delegate)resulterar i ett anrop till antingen onSignUpCodeRequired() eller onSignUpStartError() delegeringsmetoder, eller till onSignUpAttributesInvalid(attributeNames: [String]) om det har implementerats i delegeringen.
Om du vill implementera SignUpStartDelegate protokoll som ett tillägg till vår klass använder du följande kodfragment:
```
extension ViewController: SignUpStartDelegate {
    func onSignUpStartError(error: MSAL.SignUpStartError) {
        resultTextView.text = "Error signing up: \(error.errorDescription ?? "no description")"
    }

    func onSignUpCodeRequired(
        newState: MSAL.SignUpCodeRequiredState,
        sentTo: String,
        channelTargetType: MSAL.MSALNativeAuthChannelType,
        codeLength: Int
    ) {
        resultTextView.text = "Verification code sent to \(sentTo)"
    }

    func onSignUpAttributesInvalid(attributeNames: [String]) {
       resultTextView.text = "Invalid attributes  \(attributeNames)"
    }
}
```
Om attributen är ogiltiga anropas metoden onSignUpAttributesInvalid(attributeNames: [String]). I det här fallet visar vi listan över ogiltiga attribut för användaren. Annars anropas onSignUpCodeRequired(newState:sentTo:channelTargetType:codeLength) för att ange att en kod har skickats för att verifiera användarens e-postadress. Förutom information som mottagaren av koden och antalet siffror i koden har den här delegatmetoden en newState parameter av typen SignUpCodeRequiredState, vilket ger oss åtkomst till två nya metoder:
- submitCode(code:delegate)
- resendCode(delegate)

Användarattribut på en eller flera sidor

För att sprida attributen på en eller flera sidor måste vi ange de attribut som vi tänker samla in på olika sidor som obligatoriska i klientkonfigurationen för kundidentitet och åtkomsthantering (CIAM).

Vi anropar signUp(parameters:delegate) utan att skicka några attribut i MSALNativeAuthSignUpParameters-instansen. Nästa steg är att anropa newState.submitCode(code: userSuppliedCode, delegate: self) för att verifiera användarens e-post.

Vi implementerar SignUpVerifyCodeDelegate-protokollet som ett tillägg till vår klass som tidigare, men den här gången måste vi implementera den valfria metoden onSignUpAttributesRequired(attributes:newState) utöver de metoder som krävs:

extension ViewController: SignUpVerifyCodeDelegate {
    func onSignUpAttributesRequired(newState: SignUpAttributesRequiredState) {
        resultTextView.text = "Attributes required"
    }

    func onSignUpVerifyCodeError(error: MSAL.VerifyCodeError, newState: MSAL.SignUpCodeRequiredState?) {
        resultTextView.text = "Error verifying code: \(error.errorDescription ?? "no description")"
    }

    func onSignUpCompleted(newState: SignInAfterSignUpState) {
        resultTextView.text = "Signed up successfully!"
    }
}

Den här delegeringsmetoden har en parameter av typen newStateSignUpAttributesRequiredState, vilket ger oss åtkomst till en ny metod:

submitAttributes(attributes:delegate)

Om du vill skicka de attribut som användaren har angett för oss använder du följande kodfragment:

let attributes = [
    "country": "United States",
    "city": "Redmond"
]

newState.submitAttributes(attributes: attributes, delegate: self)

Vi implementerar även SignUpAttributesRequiredDelegate-protokollet som ett tillägg till vår klass:

extension ViewController: SignUpAttributesRequiredDelegate {
    func onSignUpAttributesRequiredError(error: AttributesRequiredError) {
        resultTextView.text = "Error submitting attributes: \(error.errorDescription ?? "no description")"
    }

    func onSignUpAttributesRequired(attributes: [MSALNativeAuthRequiredAttribute], newState: SignUpAttributesRequiredState) {
        resultTextView.text = "Attributes required"
    }

    func onSignUpAttributesInvalid(attributeNames: [String], newState: SignUpAttributesRequiredState) {
        resultTextView.text = "Attributes invalid"
    }

    func onSignUpCompleted(newState: SignInAfterSignUpState) {
        resultTextView.text = "Signed up successfully!"
    }
}

När användaren inte anger alla obligatoriska attribut, eller om attributen är ogiltiga, anropas dessa ombudsmetoder:

onSignUpAttributesInvalid: anger att ett eller flera attribut som skickades misslyckades med validering av indata. Det här felet innehåller parametern attributeNames, som är en lista över alla attribut som skickades av utvecklaren som inte kunde validera indata.
onSignUpAttributesRequired: anger att servern kräver att ett eller flera attribut skickas innan användarkontot kan skapas. Detta inträffar när ett eller flera attribut anges som obligatoriska i klientkonfigurationen. Det här resultatet innehåller attributparametern, som är en lista över MSALNativeAuthRequiredAttribute objekt, som beskriver information om de användarattribut som API:et kräver.

Båda delegeringsmetoderna innehåller en ny tillståndsreferens. Vi använder parametern newState för att anropa submitAttributes(attributes:delegate) igen med de nya attributen.

Under registreringen lyckas inte alla åtgärder. Användaren kan till exempel försöka registrera sig med en e-postadress som redan används eller skicka en ogiltig kod.

I vår tidigare implementering av SignUpStartDelegate-protokollet visade vi bara felet när vi hanterade den delegerade funktionen onSignUpStartError(error).

Om du vill förbättra användarupplevelsen genom att hantera den specifika feltypen använder du följande kodfragment:

func onSignUpStartError(error: MSAL.SignUpStartError) {
    if error.isUserAlreadyExists {
        resultTextView.text = "Unable to sign up: User already exists"
    } else if error.isInvalidPassword {
        resultTextView.text = "Unable to sign up: The password is invalid"
    } else if error.isInvalidUsername {
        resultTextView.text = "Unable to sign up: The username is invalid"
    } else {
        resultTextView.text = "Unexpected error signing up: \(error.errorDescription ?? "no description")"
    }
}

Efter ett lyckat registreringsflöde kan du logga in en användare utan att initiera ett inloggningsflöde. Läs mer i handledningen : Logga in användare automatiskt efter registrering i en iOS/macOS-appsartikel.

Nästa steg

Självstudie: Lägga till inloggning och utloggning i iOS/macOS-appen med inbyggd autentisering

Dela via

Förutsättningar

Användarattribut på en eller flera sidor

Nästa steg

Feedback

Ytterligare resurser

Dela via

Självstudie: Lägga till registrering i en iOS/macOS-app med inbyggd autentisering

Förutsättningar

Registrera en användare

Samla in användarattribut under registreringen

Användarattribut på en eller flera sidor

Hantera registreringsfel

Valfritt: Logga in efter ett registreringsflöde

Nästa steg

Feedback

Ytterligare resurser