hive_client/client/authentication/
error.rs

1use crate::client::authentication::ChallengeRequest;
2use aws_cognito_srp::SrpError;
3use aws_sdk_cognitoidentityprovider::error::SdkError;
4use thiserror::Error;
5
6#[derive(Error, Debug)]
7#[error(transparent)]
8#[non_exhaustive]
9/// Errors that can occur while trying to communicate with the Hive Authentication servers.
10pub enum AuthenticationError {
11    #[error("The session token was not found in the response")]
12    /// No Access Token was issued in the response from the Hive authentication servers.
13    InvalidAccessToken,
14
15    #[error("The presented challenge is not supported. Challenge was: {0}")]
16    /// The challenge presented by the Hive authentication servers is not supported by this crate.
17    UnsupportedChallenge(String),
18
19    #[error(transparent)]
20    /// The request to begin the authentication flow failed.
21    LoginFailed(
22        #[from]
23        SdkError<aws_sdk_cognitoidentityprovider::operation::initiate_auth::InitiateAuthError>,
24    ),
25
26    #[error(transparent)]
27    /// The request to respond to a challenge during the authentication flow failed.
28    ChallengeFailed(
29        #[from]
30        SdkError<aws_sdk_cognitoidentityprovider::operation::respond_to_auth_challenge::RespondToAuthChallengeError>,
31    ),
32
33    #[error("The challenge was not handled correctly")]
34    /// A parameter which was expected to be present in the challenge was not found.
35    MissingChallengeParameter(String),
36
37    #[error("An error occurred while trying to authenticate the user")]
38    /// An error occured while trying to complete the [Secure Remote Password (SRP)](https://github.com/ryanmab/aws-cognito-srp) authentication challenges.
39    SrpFailed(
40        #[from]
41        SrpError,
42    ),
43
44    #[error("A challenge was requested")]
45    /// A challenge was requested by the Hive authentication servers which requires manual intervention.
46    ///
47    /// For example, a SMS MFA code was sent to the user's phone number.
48    NextChallenge(ChallengeRequest),
49
50    /// The request to confirm the device (to make it a [`crate::authentication::TrustedDevice`]) failed.
51    DeviceConfirmationError(
52        #[from]
53        DeviceConfirmationError
54    ),
55
56    #[error("There is currently no valid authentication in progress")]
57    /// There is no authentication flow currently in progress, and the user is not logged in.
58    NoAuthenticationInProgress,
59}
60
61#[derive(Error, Debug)]
62#[error(transparent)]
63/// Errors that can occur while trying to refresh an existing authentication.
64pub enum RefreshError {
65    #[error(
66        "The request to refresh the authentication tokens failed as the access token could not be validated"
67    )]
68    /// The request to refresh the authentication tokens failed as the access token could
69    /// not be validated.
70    InvalidAccessToken,
71
72    #[error("The request to refresh the authentication tokens failed")]
73    /// The request to refresh the authentication tokens failed.
74    RequestFailed(String),
75
76    #[error("There is currently no valid authentication in progress")]
77    /// There is no authentication flow currently in progress, and the user is not logged in.
78    NotLoggedIn,
79}
80
81#[derive(Error, Debug)]
82#[error(transparent)]
83/// Errors that can occur while trying to confirm a device in order to
84/// make it a [`crate::authentication::TrustedDevice`].
85pub enum DeviceConfirmationError {
86    #[error(transparent)]
87    /// The request to confirm the device failed.
88    ConfirmationFailed(
89        #[from]
90        SdkError<aws_sdk_cognitoidentityprovider::operation::confirm_device::ConfirmDeviceError>,
91    ),
92
93    #[error(transparent)]
94    /// The request to update the device status failed.
95    StatusUpdateFailed(
96        #[from]
97        SdkError<aws_sdk_cognitoidentityprovider::operation::update_device_status::UpdateDeviceStatusError>,
98    ),
99
100    #[error("The device being confirmed is already tracked")]
101    /// The device being confirmed is already tracked, meaning no confirmation is needed.
102    DeviceAlreadyTracked,
103}
hive_client/client/authentication/error.rs

hive_client/client/authentication/
error.rs
