/* * Copyright 2018-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with * the License. A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions * and limitations under the License. */ package com.amazonaws.services.cognitoidp.model; import java.io.Serializable; import javax.annotation.Generated; import com.amazonaws.AmazonWebServiceRequest; /** *

* Represents the request to register a user. *

* * @see AWS API * Documentation */ @Generated("com.amazonaws:aws-java-sdk-code-generator") public class SignUpRequest extends com.amazonaws.AmazonWebServiceRequest implements Serializable, Cloneable { /** *

* The ID of the client associated with the user pool. *

*/ private String clientId; /** *

* A keyed-hash message authentication code (HMAC) calculated using the secret key of a user pool client and * username plus the client ID in the message. *

*/ private String secretHash; /** *

* The user name of the user you want to register. *

*/ private String username; /** *

* The password of the user you want to register. *

*/ private String password; /** *

* An array of name-value pairs representing user attributes. *

*

* For custom attributes, you must prepend the custom: prefix to the attribute name. *

*/ private java.util.List userAttributes; /** *

* The validation data in the request to register a user. *

*/ private java.util.List validationData; /** *

* The Amazon Pinpoint analytics metadata that contributes to your metrics for SignUp calls. *

*/ private AnalyticsMetadataType analyticsMetadata; /** *

* Contextual data about your user session, such as the device fingerprint, IP address, or location. Amazon Cognito * advanced security evaluates the risk of an authentication event based on the context that your app generates and * passes to Amazon Cognito when it makes API requests. *

*/ private UserContextDataType userContextData; /** *

* A map of custom key-value pairs that you can provide as input for any custom workflows that this action triggers. *

*

* You create custom workflows by assigning Lambda functions to user pool triggers. When you use the SignUp API * action, Amazon Cognito invokes any functions that are assigned to the following triggers: pre sign-up, * custom message, and post confirmation. When Amazon Cognito invokes any of these functions, it * passes a JSON payload, which the function receives as input. This payload contains a clientMetadata * attribute, which provides the data that you assigned to the ClientMetadata parameter in your SignUp request. In * your function code in Lambda, you can process the clientMetadata value to enhance your workflow for * your specific needs. *

*

* For more information, see Customizing user pool Workflows with Lambda Triggers in the Amazon Cognito Developer Guide. *

* *

* When you use the ClientMetadata parameter, remember that Amazon Cognito won't do the following: *

*
    *
  • *

    * Store the ClientMetadata value. This data is available only to Lambda triggers that are assigned to a user pool * to support custom workflows. If your user pool configuration doesn't include triggers, the ClientMetadata * parameter serves no purpose. *

    *
  • *
  • *

    * Validate the ClientMetadata value. *

    *
  • *
  • *

    * Encrypt the ClientMetadata value. Don't use Amazon Cognito to provide sensitive information. *

    *
  • *
*
*/ private java.util.Map clientMetadata; /** *

* The ID of the client associated with the user pool. *

* * @param clientId * The ID of the client associated with the user pool. */ public void setClientId(String clientId) { this.clientId = clientId; } /** *

* The ID of the client associated with the user pool. *

* * @return The ID of the client associated with the user pool. */ public String getClientId() { return this.clientId; } /** *

* The ID of the client associated with the user pool. *

* * @param clientId * The ID of the client associated with the user pool. * @return Returns a reference to this object so that method calls can be chained together. */ public SignUpRequest withClientId(String clientId) { setClientId(clientId); return this; } /** *

* A keyed-hash message authentication code (HMAC) calculated using the secret key of a user pool client and * username plus the client ID in the message. *

* * @param secretHash * A keyed-hash message authentication code (HMAC) calculated using the secret key of a user pool client and * username plus the client ID in the message. */ public void setSecretHash(String secretHash) { this.secretHash = secretHash; } /** *

* A keyed-hash message authentication code (HMAC) calculated using the secret key of a user pool client and * username plus the client ID in the message. *

* * @return A keyed-hash message authentication code (HMAC) calculated using the secret key of a user pool client and * username plus the client ID in the message. */ public String getSecretHash() { return this.secretHash; } /** *

* A keyed-hash message authentication code (HMAC) calculated using the secret key of a user pool client and * username plus the client ID in the message. *

* * @param secretHash * A keyed-hash message authentication code (HMAC) calculated using the secret key of a user pool client and * username plus the client ID in the message. * @return Returns a reference to this object so that method calls can be chained together. */ public SignUpRequest withSecretHash(String secretHash) { setSecretHash(secretHash); return this; } /** *

* The user name of the user you want to register. *

* * @param username * The user name of the user you want to register. */ public void setUsername(String username) { this.username = username; } /** *

* The user name of the user you want to register. *

* * @return The user name of the user you want to register. */ public String getUsername() { return this.username; } /** *

* The user name of the user you want to register. *

* * @param username * The user name of the user you want to register. * @return Returns a reference to this object so that method calls can be chained together. */ public SignUpRequest withUsername(String username) { setUsername(username); return this; } /** *

* The password of the user you want to register. *

* * @param password * The password of the user you want to register. */ public void setPassword(String password) { this.password = password; } /** *

* The password of the user you want to register. *

* * @return The password of the user you want to register. */ public String getPassword() { return this.password; } /** *

* The password of the user you want to register. *

* * @param password * The password of the user you want to register. * @return Returns a reference to this object so that method calls can be chained together. */ public SignUpRequest withPassword(String password) { setPassword(password); return this; } /** *

* An array of name-value pairs representing user attributes. *

*

* For custom attributes, you must prepend the custom: prefix to the attribute name. *

* * @return An array of name-value pairs representing user attributes.

*

* For custom attributes, you must prepend the custom: prefix to the attribute name. */ public java.util.List getUserAttributes() { return userAttributes; } /** *

* An array of name-value pairs representing user attributes. *

*

* For custom attributes, you must prepend the custom: prefix to the attribute name. *

* * @param userAttributes * An array of name-value pairs representing user attributes.

*

* For custom attributes, you must prepend the custom: prefix to the attribute name. */ public void setUserAttributes(java.util.Collection userAttributes) { if (userAttributes == null) { this.userAttributes = null; return; } this.userAttributes = new java.util.ArrayList(userAttributes); } /** *

* An array of name-value pairs representing user attributes. *

*

* For custom attributes, you must prepend the custom: prefix to the attribute name. *

*

* NOTE: This method appends the values to the existing list (if any). Use * {@link #setUserAttributes(java.util.Collection)} or {@link #withUserAttributes(java.util.Collection)} if you want * to override the existing values. *

* * @param userAttributes * An array of name-value pairs representing user attributes.

*

* For custom attributes, you must prepend the custom: prefix to the attribute name. * @return Returns a reference to this object so that method calls can be chained together. */ public SignUpRequest withUserAttributes(AttributeType... userAttributes) { if (this.userAttributes == null) { setUserAttributes(new java.util.ArrayList(userAttributes.length)); } for (AttributeType ele : userAttributes) { this.userAttributes.add(ele); } return this; } /** *

* An array of name-value pairs representing user attributes. *

*

* For custom attributes, you must prepend the custom: prefix to the attribute name. *

* * @param userAttributes * An array of name-value pairs representing user attributes.

*

* For custom attributes, you must prepend the custom: prefix to the attribute name. * @return Returns a reference to this object so that method calls can be chained together. */ public SignUpRequest withUserAttributes(java.util.Collection userAttributes) { setUserAttributes(userAttributes); return this; } /** *

* The validation data in the request to register a user. *

* * @return The validation data in the request to register a user. */ public java.util.List getValidationData() { return validationData; } /** *

* The validation data in the request to register a user. *

* * @param validationData * The validation data in the request to register a user. */ public void setValidationData(java.util.Collection validationData) { if (validationData == null) { this.validationData = null; return; } this.validationData = new java.util.ArrayList(validationData); } /** *

* The validation data in the request to register a user. *

*

* NOTE: This method appends the values to the existing list (if any). Use * {@link #setValidationData(java.util.Collection)} or {@link #withValidationData(java.util.Collection)} if you want * to override the existing values. *

* * @param validationData * The validation data in the request to register a user. * @return Returns a reference to this object so that method calls can be chained together. */ public SignUpRequest withValidationData(AttributeType... validationData) { if (this.validationData == null) { setValidationData(new java.util.ArrayList(validationData.length)); } for (AttributeType ele : validationData) { this.validationData.add(ele); } return this; } /** *

* The validation data in the request to register a user. *

* * @param validationData * The validation data in the request to register a user. * @return Returns a reference to this object so that method calls can be chained together. */ public SignUpRequest withValidationData(java.util.Collection validationData) { setValidationData(validationData); return this; } /** *

* The Amazon Pinpoint analytics metadata that contributes to your metrics for SignUp calls. *

* * @param analyticsMetadata * The Amazon Pinpoint analytics metadata that contributes to your metrics for SignUp calls. */ public void setAnalyticsMetadata(AnalyticsMetadataType analyticsMetadata) { this.analyticsMetadata = analyticsMetadata; } /** *

* The Amazon Pinpoint analytics metadata that contributes to your metrics for SignUp calls. *

* * @return The Amazon Pinpoint analytics metadata that contributes to your metrics for SignUp calls. */ public AnalyticsMetadataType getAnalyticsMetadata() { return this.analyticsMetadata; } /** *

* The Amazon Pinpoint analytics metadata that contributes to your metrics for SignUp calls. *

* * @param analyticsMetadata * The Amazon Pinpoint analytics metadata that contributes to your metrics for SignUp calls. * @return Returns a reference to this object so that method calls can be chained together. */ public SignUpRequest withAnalyticsMetadata(AnalyticsMetadataType analyticsMetadata) { setAnalyticsMetadata(analyticsMetadata); return this; } /** *

* Contextual data about your user session, such as the device fingerprint, IP address, or location. Amazon Cognito * advanced security evaluates the risk of an authentication event based on the context that your app generates and * passes to Amazon Cognito when it makes API requests. *

* * @param userContextData * Contextual data about your user session, such as the device fingerprint, IP address, or location. Amazon * Cognito advanced security evaluates the risk of an authentication event based on the context that your app * generates and passes to Amazon Cognito when it makes API requests. */ public void setUserContextData(UserContextDataType userContextData) { this.userContextData = userContextData; } /** *

* Contextual data about your user session, such as the device fingerprint, IP address, or location. Amazon Cognito * advanced security evaluates the risk of an authentication event based on the context that your app generates and * passes to Amazon Cognito when it makes API requests. *

* * @return Contextual data about your user session, such as the device fingerprint, IP address, or location. Amazon * Cognito advanced security evaluates the risk of an authentication event based on the context that your * app generates and passes to Amazon Cognito when it makes API requests. */ public UserContextDataType getUserContextData() { return this.userContextData; } /** *

* Contextual data about your user session, such as the device fingerprint, IP address, or location. Amazon Cognito * advanced security evaluates the risk of an authentication event based on the context that your app generates and * passes to Amazon Cognito when it makes API requests. *

* * @param userContextData * Contextual data about your user session, such as the device fingerprint, IP address, or location. Amazon * Cognito advanced security evaluates the risk of an authentication event based on the context that your app * generates and passes to Amazon Cognito when it makes API requests. * @return Returns a reference to this object so that method calls can be chained together. */ public SignUpRequest withUserContextData(UserContextDataType userContextData) { setUserContextData(userContextData); return this; } /** *

* A map of custom key-value pairs that you can provide as input for any custom workflows that this action triggers. *

*

* You create custom workflows by assigning Lambda functions to user pool triggers. When you use the SignUp API * action, Amazon Cognito invokes any functions that are assigned to the following triggers: pre sign-up, * custom message, and post confirmation. When Amazon Cognito invokes any of these functions, it * passes a JSON payload, which the function receives as input. This payload contains a clientMetadata * attribute, which provides the data that you assigned to the ClientMetadata parameter in your SignUp request. In * your function code in Lambda, you can process the clientMetadata value to enhance your workflow for * your specific needs. *

*

* For more information, see Customizing user pool Workflows with Lambda Triggers in the Amazon Cognito Developer Guide. *

* *

* When you use the ClientMetadata parameter, remember that Amazon Cognito won't do the following: *

*
    *
  • *

    * Store the ClientMetadata value. This data is available only to Lambda triggers that are assigned to a user pool * to support custom workflows. If your user pool configuration doesn't include triggers, the ClientMetadata * parameter serves no purpose. *

    *
  • *
  • *

    * Validate the ClientMetadata value. *

    *
  • *
  • *

    * Encrypt the ClientMetadata value. Don't use Amazon Cognito to provide sensitive information. *

    *
  • *
*
* * @return A map of custom key-value pairs that you can provide as input for any custom workflows that this action * triggers.

*

* You create custom workflows by assigning Lambda functions to user pool triggers. When you use the SignUp * API action, Amazon Cognito invokes any functions that are assigned to the following triggers: pre * sign-up, custom message, and post confirmation. When Amazon Cognito invokes any of * these functions, it passes a JSON payload, which the function receives as input. This payload contains a * clientMetadata attribute, which provides the data that you assigned to the ClientMetadata * parameter in your SignUp request. In your function code in Lambda, you can process the * clientMetadata value to enhance your workflow for your specific needs. *

*

* For more information, see Customizing user pool Workflows with Lambda Triggers in the Amazon Cognito Developer Guide. *

* *

* When you use the ClientMetadata parameter, remember that Amazon Cognito won't do the following: *

*
    *
  • *

    * Store the ClientMetadata value. This data is available only to Lambda triggers that are assigned to a * user pool to support custom workflows. If your user pool configuration doesn't include triggers, the * ClientMetadata parameter serves no purpose. *

    *
  • *
  • *

    * Validate the ClientMetadata value. *

    *
  • *
  • *

    * Encrypt the ClientMetadata value. Don't use Amazon Cognito to provide sensitive information. *

    *
  • *
*/ public java.util.Map getClientMetadata() { return clientMetadata; } /** *

* A map of custom key-value pairs that you can provide as input for any custom workflows that this action triggers. *

*

* You create custom workflows by assigning Lambda functions to user pool triggers. When you use the SignUp API * action, Amazon Cognito invokes any functions that are assigned to the following triggers: pre sign-up, * custom message, and post confirmation. When Amazon Cognito invokes any of these functions, it * passes a JSON payload, which the function receives as input. This payload contains a clientMetadata * attribute, which provides the data that you assigned to the ClientMetadata parameter in your SignUp request. In * your function code in Lambda, you can process the clientMetadata value to enhance your workflow for * your specific needs. *

*

* For more information, see Customizing user pool Workflows with Lambda Triggers in the Amazon Cognito Developer Guide. *

* *

* When you use the ClientMetadata parameter, remember that Amazon Cognito won't do the following: *

*
    *
  • *

    * Store the ClientMetadata value. This data is available only to Lambda triggers that are assigned to a user pool * to support custom workflows. If your user pool configuration doesn't include triggers, the ClientMetadata * parameter serves no purpose. *

    *
  • *
  • *

    * Validate the ClientMetadata value. *

    *
  • *
  • *

    * Encrypt the ClientMetadata value. Don't use Amazon Cognito to provide sensitive information. *

    *
  • *
*
* * @param clientMetadata * A map of custom key-value pairs that you can provide as input for any custom workflows that this action * triggers.

*

* You create custom workflows by assigning Lambda functions to user pool triggers. When you use the SignUp * API action, Amazon Cognito invokes any functions that are assigned to the following triggers: pre * sign-up, custom message, and post confirmation. When Amazon Cognito invokes any of these * functions, it passes a JSON payload, which the function receives as input. This payload contains a * clientMetadata attribute, which provides the data that you assigned to the ClientMetadata * parameter in your SignUp request. In your function code in Lambda, you can process the * clientMetadata value to enhance your workflow for your specific needs. *

*

* For more information, see Customizing user pool Workflows with Lambda Triggers in the Amazon Cognito Developer Guide. *

* *

* When you use the ClientMetadata parameter, remember that Amazon Cognito won't do the following: *

*
    *
  • *

    * Store the ClientMetadata value. This data is available only to Lambda triggers that are assigned to a user * pool to support custom workflows. If your user pool configuration doesn't include triggers, the * ClientMetadata parameter serves no purpose. *

    *
  • *
  • *

    * Validate the ClientMetadata value. *

    *
  • *
  • *

    * Encrypt the ClientMetadata value. Don't use Amazon Cognito to provide sensitive information. *

    *
  • *
*/ public void setClientMetadata(java.util.Map clientMetadata) { this.clientMetadata = clientMetadata; } /** *

* A map of custom key-value pairs that you can provide as input for any custom workflows that this action triggers. *

*

* You create custom workflows by assigning Lambda functions to user pool triggers. When you use the SignUp API * action, Amazon Cognito invokes any functions that are assigned to the following triggers: pre sign-up, * custom message, and post confirmation. When Amazon Cognito invokes any of these functions, it * passes a JSON payload, which the function receives as input. This payload contains a clientMetadata * attribute, which provides the data that you assigned to the ClientMetadata parameter in your SignUp request. In * your function code in Lambda, you can process the clientMetadata value to enhance your workflow for * your specific needs. *

*

* For more information, see Customizing user pool Workflows with Lambda Triggers in the Amazon Cognito Developer Guide. *

* *

* When you use the ClientMetadata parameter, remember that Amazon Cognito won't do the following: *

*
    *
  • *

    * Store the ClientMetadata value. This data is available only to Lambda triggers that are assigned to a user pool * to support custom workflows. If your user pool configuration doesn't include triggers, the ClientMetadata * parameter serves no purpose. *

    *
  • *
  • *

    * Validate the ClientMetadata value. *

    *
  • *
  • *

    * Encrypt the ClientMetadata value. Don't use Amazon Cognito to provide sensitive information. *

    *
  • *
*
* * @param clientMetadata * A map of custom key-value pairs that you can provide as input for any custom workflows that this action * triggers.

*

* You create custom workflows by assigning Lambda functions to user pool triggers. When you use the SignUp * API action, Amazon Cognito invokes any functions that are assigned to the following triggers: pre * sign-up, custom message, and post confirmation. When Amazon Cognito invokes any of these * functions, it passes a JSON payload, which the function receives as input. This payload contains a * clientMetadata attribute, which provides the data that you assigned to the ClientMetadata * parameter in your SignUp request. In your function code in Lambda, you can process the * clientMetadata value to enhance your workflow for your specific needs. *

*

* For more information, see Customizing user pool Workflows with Lambda Triggers in the Amazon Cognito Developer Guide. *

* *

* When you use the ClientMetadata parameter, remember that Amazon Cognito won't do the following: *

*
    *
  • *

    * Store the ClientMetadata value. This data is available only to Lambda triggers that are assigned to a user * pool to support custom workflows. If your user pool configuration doesn't include triggers, the * ClientMetadata parameter serves no purpose. *

    *
  • *
  • *

    * Validate the ClientMetadata value. *

    *
  • *
  • *

    * Encrypt the ClientMetadata value. Don't use Amazon Cognito to provide sensitive information. *

    *
  • *
* @return Returns a reference to this object so that method calls can be chained together. */ public SignUpRequest withClientMetadata(java.util.Map clientMetadata) { setClientMetadata(clientMetadata); return this; } /** * Add a single ClientMetadata entry * * @see SignUpRequest#withClientMetadata * @returns a reference to this object so that method calls can be chained together. */ public SignUpRequest addClientMetadataEntry(String key, String value) { if (null == this.clientMetadata) { this.clientMetadata = new java.util.HashMap(); } if (this.clientMetadata.containsKey(key)) throw new IllegalArgumentException("Duplicated keys (" + key.toString() + ") are provided."); this.clientMetadata.put(key, value); return this; } /** * Removes all the entries added into ClientMetadata. * * @return Returns a reference to this object so that method calls can be chained together. */ public SignUpRequest clearClientMetadataEntries() { this.clientMetadata = null; return this; } /** * Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be * redacted from this string using a placeholder value. * * @return A string representation of this object. * * @see java.lang.Object#toString() */ @Override public String toString() { StringBuilder sb = new StringBuilder(); sb.append("{"); if (getClientId() != null) sb.append("ClientId: ").append("***Sensitive Data Redacted***").append(","); if (getSecretHash() != null) sb.append("SecretHash: ").append("***Sensitive Data Redacted***").append(","); if (getUsername() != null) sb.append("Username: ").append("***Sensitive Data Redacted***").append(","); if (getPassword() != null) sb.append("Password: ").append("***Sensitive Data Redacted***").append(","); if (getUserAttributes() != null) sb.append("UserAttributes: ").append(getUserAttributes()).append(","); if (getValidationData() != null) sb.append("ValidationData: ").append(getValidationData()).append(","); if (getAnalyticsMetadata() != null) sb.append("AnalyticsMetadata: ").append(getAnalyticsMetadata()).append(","); if (getUserContextData() != null) sb.append("UserContextData: ").append("***Sensitive Data Redacted***").append(","); if (getClientMetadata() != null) sb.append("ClientMetadata: ").append(getClientMetadata()); sb.append("}"); return sb.toString(); } @Override public boolean equals(Object obj) { if (this == obj) return true; if (obj == null) return false; if (obj instanceof SignUpRequest == false) return false; SignUpRequest other = (SignUpRequest) obj; if (other.getClientId() == null ^ this.getClientId() == null) return false; if (other.getClientId() != null && other.getClientId().equals(this.getClientId()) == false) return false; if (other.getSecretHash() == null ^ this.getSecretHash() == null) return false; if (other.getSecretHash() != null && other.getSecretHash().equals(this.getSecretHash()) == false) return false; if (other.getUsername() == null ^ this.getUsername() == null) return false; if (other.getUsername() != null && other.getUsername().equals(this.getUsername()) == false) return false; if (other.getPassword() == null ^ this.getPassword() == null) return false; if (other.getPassword() != null && other.getPassword().equals(this.getPassword()) == false) return false; if (other.getUserAttributes() == null ^ this.getUserAttributes() == null) return false; if (other.getUserAttributes() != null && other.getUserAttributes().equals(this.getUserAttributes()) == false) return false; if (other.getValidationData() == null ^ this.getValidationData() == null) return false; if (other.getValidationData() != null && other.getValidationData().equals(this.getValidationData()) == false) return false; if (other.getAnalyticsMetadata() == null ^ this.getAnalyticsMetadata() == null) return false; if (other.getAnalyticsMetadata() != null && other.getAnalyticsMetadata().equals(this.getAnalyticsMetadata()) == false) return false; if (other.getUserContextData() == null ^ this.getUserContextData() == null) return false; if (other.getUserContextData() != null && other.getUserContextData().equals(this.getUserContextData()) == false) return false; if (other.getClientMetadata() == null ^ this.getClientMetadata() == null) return false; if (other.getClientMetadata() != null && other.getClientMetadata().equals(this.getClientMetadata()) == false) return false; return true; } @Override public int hashCode() { final int prime = 31; int hashCode = 1; hashCode = prime * hashCode + ((getClientId() == null) ? 0 : getClientId().hashCode()); hashCode = prime * hashCode + ((getSecretHash() == null) ? 0 : getSecretHash().hashCode()); hashCode = prime * hashCode + ((getUsername() == null) ? 0 : getUsername().hashCode()); hashCode = prime * hashCode + ((getPassword() == null) ? 0 : getPassword().hashCode()); hashCode = prime * hashCode + ((getUserAttributes() == null) ? 0 : getUserAttributes().hashCode()); hashCode = prime * hashCode + ((getValidationData() == null) ? 0 : getValidationData().hashCode()); hashCode = prime * hashCode + ((getAnalyticsMetadata() == null) ? 0 : getAnalyticsMetadata().hashCode()); hashCode = prime * hashCode + ((getUserContextData() == null) ? 0 : getUserContextData().hashCode()); hashCode = prime * hashCode + ((getClientMetadata() == null) ? 0 : getClientMetadata().hashCode()); return hashCode; } @Override public SignUpRequest clone() { return (SignUpRequest) super.clone(); } }