Skip to content

Mds/okta 524282/okta 528021 update mobile sdk overview#4332

Open
mauricesharp-okta wants to merge 6 commits intomasterfrom
mds/OKTA-524282/OKTA-528021-update-mobile-sdk-overview
Open

Mds/okta 524282/okta 528021 update mobile sdk overview#4332
mauricesharp-okta wants to merge 6 commits intomasterfrom
mds/OKTA-524282/OKTA-528021-update-mobile-sdk-overview

Conversation

@mauricesharp-okta
Copy link
Contributor

@mauricesharp-okta mauricesharp-okta commented Aug 22, 2023 •
edited
Loading

Latest preview build (Sep 5 5:15PM Eastern)

Android/Kotlin
Swift/iOS

Description:

What's changed?

  • Updated the mobile SDK Overview for the latest versions of the Kotlin and Swift Okta Identity Engine SDK
  • Includes change some of the object types used in the sign-in flow, including InteractionCodeFlow
  • Updated images and tables to use new objects
  • Updated text to use new objects
  • Updated code in examples to use new objects
  • For Swift, updated the code to use InteractionCodeFlowDelegate and to publish the relevant state variables.

Is this PR related to a Monolith release?
No

Resolves:

@mauricesharp-okta
Initial updates
0a4b1c6 
- Updated main index and diagrams for modified object names.
- Initial update of iOS
- Added and modified new files for Android
@mauricesharp-okta
Updates to Android content
1ae0c6c
@mauricesharp-okta
Updated code and text for new SDK
5785b8e
@mauricesharp-okta
Clean up wording in a few areas
2d285d4
rajdeepnanua-okta
rajdeepnanua-okta approved these changes Aug 22, 2023
View reviewed changes
Copy link

@rajdeepnanua-okta rajdeepnanua-okta left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good. Left a suggestion for updating a diagram

danielmaharry-okta
danielmaharry-okta requested changes Aug 25, 2023
View reviewed changes
Copy link
Contributor

@danielmaharry-okta danielmaharry-okta left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Weird case of deja vu here in that the Kotlin SDK class diagram doesn't match the text. I know I did a PR review for you where this was also true. Also have suggested a few spots where code lines are too long for a midsized browser window. I don't know how easy it is to split Swift code over two lines though.

@mauricesharp-okta
Incoroprate review comments
88b0ae4 
- Fine tuned text based on review comments
- Revised the Android flow image to use proper object names
alexnachbaur-okta
alexnachbaur-okta reviewed Aug 30, 2023
View reviewed changes
packages/@okta/vuepress-site/docs/guides/mobile-idx-sdk-overview/main/index.md Outdated
- **Authenticator:** Represents an authenticator that's used to verify the identity of a user, such as Okta Verify.
- **Method:** Represents a channel for an authenticator, such as using SMS or voice for an authenticator that uses a phone. An authenticator may have zero or more.
- **Method:** Represents a channel for an authenticator, such as using SMS or voice for an authenticator that uses a phone. An authenticator may have zero or more methods.
- **Capability:** A user action associated with a remediation, authenticator, or method, such as requesting a new OTP or a password reset.
Copy link
Contributor

@alexnachbaur-okta alexnachbaur-okta Aug 30, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A capability can also indicate additional data associated with an authenticator that isn't always present. For example, a Password authenticator may sometimes return "PasswordSettings" to describe the password complexity requirements (usually only available when setting a new password). Another useful one is the "Profile" capability, which returns additional display information for the authenticator that can be used to render a UI (such as the redacted email address or phone number used within an authenticator).

Copy link
Contributor Author

@mauricesharp-okta mauricesharp-okta Sep 5, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How's this?

  • Capability: A user action or additional information that is associated with a remediation, authenticator, or method, such as requesting a new OTP or a redacted email.

Copy link
Contributor

@alexnachbaur-okta alexnachbaur-okta Sep 5, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. Instead of "redacted email", I'd clarify further, such as: "or the email address or phone number associated with the authenticator (redacted for security)."

@alexnachbaur-okta
Copy link
Contributor

alexnachbaur-okta commented Aug 31, 2023

For the Swift samples, is it using the new code in the SwiftUI-Improvements branch?

danielmaharry-okta
danielmaharry-okta requested changes Aug 31, 2023
View reviewed changes
Copy link
Contributor

@danielmaharry-okta danielmaharry-okta left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@mauricesharp-okta
Copy link
Contributor Author

mauricesharp-okta commented Sep 5, 2023

/netlify preview

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@danielmaharry-okta danielmaharry-okta danielmaharry-okta approved these changes

+2 more reviewers

@alexnachbaur-okta alexnachbaur-okta alexnachbaur-okta left review comments

@rajdeepnanua-okta rajdeepnanua-okta rajdeepnanua-okta approved these changes

Reviewers whose approvals may not affect merge requirements

At least 1 approving review is required to merge this pull request.

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

4 participants

@mauricesharp-okta @alexnachbaur-okta @danielmaharry-okta @rajdeepnanua-okta