The best way to control Claude Code, Codex and more from any computer or phone
| 1 | import * as iam from "@distilled.cloud/aws/iam"; |
| 2 | import { isResolved } from "alchemy/Diff"; |
| 3 | import * as Provider from "alchemy/Provider"; |
| 4 | import { Resource } from "alchemy/Resource"; |
| 5 | import * as Effect from "effect/Effect"; |
| 6 | import * as Redacted from "effect/Redacted"; |
| 7 | import * as Stream from "effect/Stream"; |
| 8 | import type { Providers } from "../Providers.ts"; |
| 9 | import { unwrapRedactedString } from "./common.ts"; |
| 10 | |
| 11 | export interface LoginProfileProps { |
| 12 | /** |
| 13 | * User that owns the console login profile. |
| 14 | */ |
| 15 | userName: string; |
| 16 | /** |
| 17 | * Console password. AWS never returns this value after create/update. |
| 18 | */ |
| 19 | password: Redacted.Redacted<string> | string; |
| 20 | /** |
| 21 | * Require a password reset on next sign in. |
| 22 | */ |
| 23 | passwordResetRequired?: boolean; |
| 24 | } |
| 25 | |
| 26 | export interface LoginProfile extends Resource< |
| 27 | "AWS.IAM.LoginProfile", |
| 28 | LoginProfileProps, |
| 29 | { |
| 30 | /** The IAM user the login profile belongs to. */ |
| 31 | userName: string; |
| 32 | /** When the login profile was created. */ |
| 33 | createDate: Date | undefined; |
| 34 | /** Whether the user must set a new password on next sign-in. */ |
| 35 | passwordResetRequired: boolean | undefined; |
| 36 | }, |
| 37 | never, |
| 38 | Providers |
| 39 | > {} |
| 40 | |
| 41 | /** |
| 42 | * An IAM console login profile for a user. |
| 43 | * |
| 44 | * `LoginProfile` manages AWS Management Console access for an IAM user. The |
| 45 | * password is write-only, so AWS never returns it during later reads. |
| 46 | * ### Managing Console Access |
| 47 | * **Example:** Create a Console Login Profile |
| 48 | * ```typescript |
| 49 | * const user = yield* User("ConsoleUser", { |
| 50 | * userName: "console-user", |
| 51 | * }); |
| 52 | * |
| 53 | * const profile = yield* LoginProfile("ConsoleLogin", { |
| 54 | * userName: user.userName, |
| 55 | * password: Redacted.make("TempPassword123!"), |
| 56 | * passwordResetRequired: true, |
| 57 | * }); |
| 58 | * ``` |
| 59 | * |
| 60 | * @resource |
| 61 | */ |
| 62 | export const LoginProfile = Resource<LoginProfile>("AWS.IAM.LoginProfile"); |
| 63 | |
| 64 | export const LoginProfileProvider = () => |
| 65 | Provider.succeed(LoginProfile, { |
| 66 | stables: ["userName"], |
| 67 | diff: Effect.fn(function* ({ olds, news }) { |
| 68 | if (!isResolved(news)) return; |
| 69 | if (olds.userName !== news.userName) { |
| 70 | return { action: "replace" } as const; |
| 71 | } |
| 72 | }), |
| 73 | read: Effect.fn(function* ({ output }) { |
| 74 | if (!output) { |
| 75 | return undefined; |
| 76 | } |
| 77 | const response = yield* iam |
| 78 | .getLoginProfile({ |
| 79 | UserName: output.userName, |
| 80 | }) |
| 81 | .pipe(Effect.catchTag("NoSuchEntityException", () => Effect.undefined)); |
| 82 | if (!response?.LoginProfile) { |
| 83 | return undefined; |
| 84 | } |
| 85 | return { |
| 86 | userName: response.LoginProfile.UserName, |
| 87 | createDate: response.LoginProfile.CreateDate, |
| 88 | passwordResetRequired: response.LoginProfile.PasswordResetRequired, |
| 89 | }; |
| 90 | }), |
| 91 | reconcile: Effect.fn(function* ({ news, session }) { |
| 92 | // Observe — read the live login profile (or absence) for the user. |
| 93 | const observed = yield* iam |
| 94 | .getLoginProfile({ UserName: news.userName }) |
| 95 | .pipe(Effect.catchTag("NoSuchEntityException", () => Effect.undefined)); |
| 96 | |
| 97 | // Ensure / Sync — the password is write-only, so we always send the |
| 98 | // desired value. Use `createLoginProfile` when the profile is |
| 99 | // missing and `updateLoginProfile` otherwise. A race that turns the |
| 100 | // create into `EntityAlreadyExistsException` is recovered by |
| 101 | // calling update. |
| 102 | let response = observed; |
| 103 | if (!observed?.LoginProfile) { |
| 104 | response = yield* iam |
| 105 | .createLoginProfile({ |
| 106 | UserName: news.userName, |
| 107 | Password: unwrapRedactedString(news.password), |
| 108 | PasswordResetRequired: news.passwordResetRequired, |
| 109 | }) |
| 110 | .pipe( |
| 111 | Effect.catchTag("EntityAlreadyExistsException", () => |
| 112 | Effect.gen(function* () { |
| 113 | yield* iam.updateLoginProfile({ |
| 114 | UserName: news.userName, |
| 115 | Password: unwrapRedactedString(news.password), |
| 116 | PasswordResetRequired: news.passwordResetRequired, |
| 117 | }); |
| 118 | return yield* iam.getLoginProfile({ |
| 119 | UserName: news.userName, |
| 120 | }); |
| 121 | }), |
| 122 | ), |
| 123 | ); |
| 124 | } else { |
| 125 | yield* iam.updateLoginProfile({ |
| 126 | UserName: news.userName, |
| 127 | Password: unwrapRedactedString(news.password), |
| 128 | PasswordResetRequired: news.passwordResetRequired, |
| 129 | }); |
| 130 | response = yield* iam.getLoginProfile({ UserName: news.userName }); |
| 131 | } |
| 132 | |
| 133 | yield* session.note(news.userName); |
| 134 | return { |
| 135 | userName: response!.LoginProfile.UserName, |
| 136 | createDate: response!.LoginProfile.CreateDate, |
| 137 | passwordResetRequired: response!.LoginProfile.PasswordResetRequired, |
| 138 | }; |
| 139 | }), |
| 140 | delete: Effect.fn(function* ({ output }) { |
| 141 | yield* iam |
| 142 | .deleteLoginProfile({ |
| 143 | UserName: output.userName, |
| 144 | }) |
| 145 | .pipe(Effect.catchTag("NoSuchEntityException", () => Effect.void)); |
| 146 | }), |
| 147 | // There is no list-login-profiles API: a login profile is a per-user |
| 148 | // singleton. Enumerate every IAM user (paginated), then probe each with |
| 149 | // `getLoginProfile`; users without console access return a typed |
| 150 | // `NoSuchEntityException`, which we skip. Bounded concurrency keeps the |
| 151 | // fan-out reasonable. |
| 152 | list: Effect.fn(function* () { |
| 153 | const users = yield* iam.listUsers.pages({}).pipe( |
| 154 | Stream.runCollect, |
| 155 | Effect.map((chunk) => Array.from(chunk).flatMap((page) => page.Users)), |
| 156 | ); |
| 157 | const profiles = yield* Effect.forEach( |
| 158 | users, |
| 159 | (user) => |
| 160 | iam.getLoginProfile({ UserName: user.UserName }).pipe( |
| 161 | Effect.map((response) => ({ |
| 162 | userName: response.LoginProfile.UserName, |
| 163 | createDate: response.LoginProfile.CreateDate, |
| 164 | passwordResetRequired: response.LoginProfile.PasswordResetRequired, |
| 165 | })), |
| 166 | // The user has no console login profile, or was deleted between |
| 167 | // enumeration and the per-user probe. |
| 168 | Effect.catchTag("NoSuchEntityException", () => Effect.undefined), |
| 169 | ), |
| 170 | { concurrency: 10 }, |
| 171 | ); |
| 172 | const result: LoginProfile["Attributes"][] = profiles.filter( |
| 173 | (profile): profile is NonNullable<typeof profile> => profile !== undefined, |
| 174 | ); |
| 175 | return result; |
| 176 | }), |
| 177 | }); |