Skip to content

update generic connector page components #3594

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
wied03 merged 4 commits into from
Mar 26, 2025
Merged

update generic connector page components #3594

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
bdf4a8d
update generic connector page components
bhalsey Mar 21, 2025
ae284ed
Connector info should reflect this as well
wied03 Mar 26, 2025
c9ceea8
Lint
wied03 Mar 26, 2025
2db68aa
Missed this update
wied03 Mar 26, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions astro/src/content/docs/lifecycle/migrate-users/connectors/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ The following Connectors are available:

If you're looking for a Connector not listed here, review the open feature requests in [GitHub](https://github.com/FusionAuth/fusionauth-issues/issues) and either vote or comment on an existing feature, or open a new feature request if you do not find an existing issue.

Find Connectors in the administrative user interface by navigating to <strong>Settings -> Connectors</strong> or use the [Connectors](/docs/apis/connectors/) APIs.
Find Connectors in the administrative user interface by navigating to **Settings -> Connectors** or use the [Connectors](/docs/apis/connectors/) APIs.

<img src="/img/docs/lifecycle/migrate-users/connectors/connectors-screen.png" alt="Choose what type of Connector to create." width="1200" role="shadowed" />

Expand All @@ -61,12 +61,12 @@ The user will be placed into the same tenant as the application they are authent

If you are authenticating a user, you must provide the following fields in the user object you return.

* `user.username` or `user.email`
* `user.username`, `user.email`, or `user.phoneNumber`
* `user.id`: a FusionAuth compatible UUID

If you are using the generic connector, you are building the `user` object, so ensure these fields are in the JSON. If you are using the LDAP connector, make sure you set these fields in the configured LDAP Reconcile lambda.

In addition, ensure that the same `user.id` is returned each time a user is retrieved. If you have an LDAP attribute in the form of a UUID or a value that can be translated to a UUID, using that attribute or its translation is recommended. If you have to generate a UUID, ensure that you are able to return the same value each time the user authenticates. Doing so ensures that FusionAuth knows which user is being referenced, even if the username or email address changes.
In addition, ensure that the same `user.id` is returned each time a user is retrieved. If you have an LDAP attribute in the form of a UUID or a value that can be translated to a UUID, using that attribute or its translation is recommended. If you have to generate a UUID, ensure that you are able to return the same value each time the user authenticates. Doing so ensures that FusionAuth knows which user is being referenced, even if the username, email address, or phone number changes.

### Suggested Fields

Expand All @@ -86,7 +86,7 @@ The user will be placed into the same tenant as the application they are authent

If you are migrating a user, you must provide the following fields in the user object you return.

* `user.username` or `user.email`
* `user.username`, `user.email`, or `user.phoneNumber`
* `user.id`: a FusionAuth compatible UUID

If you are using the generic connector, you are building the `user` object, so ensure these fields are in the JSON. If you are using the LDAP connector, make sure you set these fields in the lambda.
Expand Down
12 changes: 8 additions & 4 deletions astro/src/content/json/login/request.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,11 @@
{
"loginId": "example@fusionauth.io",
"password": "password",
"applicationId": "10000000-0000-0002-0000-000000000001",
"eventInfo" : {
"ipAddress" : "127.0.0.1"
},
"loginId": "example@fusionauth.io",
"loginIdTypes": ["email"],
"newDevice" : false,
"noJWT": false,
"ipAddress": "192.168.1.42"
}
"password": "password"
}