Skip to content
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.

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

Telephony #1520

Merged
merged 7 commits into from
Aug 16, 2024
Merged

Telephony #1520

merged 7 commits into from
Aug 16, 2024

Conversation

edunham
Copy link
Member

@edunham edunham commented Aug 15, 2024

  • add CTA
  • check md rendering
  • fix communities list

Copy link

netlify bot commented Aug 15, 2024

Deploy Preview for okta-blog ready!

Name Link
🔨 Latest commit 709c0a7
🔍 Latest deploy log https://app.netlify.com/sites/okta-blog/deploys/66be980842f5d200085586b6
😎 Deploy Preview https://deploy-preview-1520--okta-blog.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@edunham edunham requested a review from isemona August 15, 2024 21:03
Copy link
Contributor

@isemona isemona left a comment

Choose a reason for hiding this comment

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

some things

_source/_posts/2024-08-15-otp-over-sms.md Show resolved Hide resolved
_source/_posts/2024-08-15-otp-over-sms.md Outdated Show resolved Hide resolved
@edunham edunham merged commit 99652c7 into oktadev:main Aug 16, 2024
6 checks passed
Copy link
Member

@alisaduncan alisaduncan left a comment

Choose a reason for hiding this comment

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

Changes requested

---
{% include toc.md %}

## Approaches to keep sending OTP over SMS... for now
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
## Approaches to keep sending OTP over SMS... for now

Please delete this header. This is the same as the title. A blog should not start immediately with a header as the title is a header. There needs to be an intro.

image: blog/telephony/social.jpg
type: conversion
---
{% include toc.md %}
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
{% include toc.md %}

Please move this below intro.


## Approaches to keep sending OTP over SMS... for now

"SMS has long played an important role as a universally applicable method of verifying a user's identity via one-time passcodes. And over the last decade, SMS and voice-based Multifactor Authentication has prevented untold attempts to compromise user accounts.
Copy link
Member

Choose a reason for hiding this comment

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

Consider using > plus citation tags. We have examples of it in the blog


* Longer login times than other methods

Okta [recommended moving away](https://www.okta.com/blog/2020/05/why-you-should-ditch-sms-as-an-auth-factor/)[ from SMS/Voice authentication](https://www.okta.com/blog/2020/05/why-you-should-ditch-sms-as-an-auth-factor/) some time ago. There are many other factors you can use for authentication, including:
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
Okta [recommended moving away](https://www.okta.com/blog/2020/05/why-you-should-ditch-sms-as-an-auth-factor/)[ from SMS/Voice authentication](https://www.okta.com/blog/2020/05/why-you-should-ditch-sms-as-an-auth-factor/) some time ago. There are many other factors you can use for authentication, including:
Okta [recommended moving away](/blog/2020/05/why-you-should-ditch-sms-as-an-auth-factor/)[ from SMS/Voice authentication](/blog/2020/05/why-you-should-ditch-sms-as-an-auth-factor/) some time ago. There are many other factors you can use for authentication, including:

Blog references do not include domain so that preview mode works. Also, consider using the new embed tag

Copy link
Member

Choose a reason for hiding this comment

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

Will people be able to distinguish between the two links?


* Generating codes in an authenticator app such as Okta Verify, Authy, Google Authenticator, or 1Password.

* FIDO2.0 (WebAuthn) which, in addition to phones, can use hardware keys and on-device authenticators.
Copy link
Member

Choose a reason for hiding this comment

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

Are you sure this is the correct term? (stating "FIDO2.0 (WebAuthn)") I'm not sure the parenthesis here is correct, probably should verify with Okta standards for reference?

Copy link
Member Author

Choose a reason for hiding this comment

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

good question; Maurice went through other reviews on the content so I'll ask


You can send the OTP in the SMS/Voice flow using the [telephony inline hook]([https://help.okta.com/oie/en-us/content/topics/telephony/telephony-inline-hook.htm](https://help.okta.com/oie/en-us/content/topics/telephony/telephony-inline-hook.htm)). Okta uses the code or URL in the hook to send the OTP, though, as you'll see, the hook may not be called every time (and that's a good thing). When your hook fails to send the message or takes too long to update the status, Okta takes over sending the message. However, the number of those messages is heavily rate-limited.

The code or URL you provide may simply send the message and communicate the outcome to Okta. The code or server may be more complex, managing geo-specific vendors, failure, failover to another provider, and hacking. No matter how easy or complex the code, there are three main approaches:
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
The code or URL you provide may simply send the message and communicate the outcome to Okta. The code or server may be more complex, managing geo-specific vendors, failure, failover to another provider, and hacking. No matter how easy or complex the code, there are three main approaches:
The code or URL you provide may simply send the message and communicate the outcome to Okta. The code or server may be more complex, managing geo-specific vendors, failure, failover to another provider, and hacking. No matter the code, there are three main approaches:

I recommend steering away from these terms for inclusivity.

Copy link
Member Author

Choose a reason for hiding this comment

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

good catch


Some of the main things to consider when choosing an approach are the regions for messages, the expected traffic, the desired reliability, branding requirements, protection from hacking, and your resources.

### Which regions?
Copy link
Member

Choose a reason for hiding this comment

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

Consider working keywords into the H2 and H3 headers for SEO. If that is at all a concern.


* Registration of a sender ID for your business. For example, messages without a valid sender ID are automatically marked as "Likely-SCAM" in Singapore.

* Using *short codes*–special telephone numbers designed for high traffic. This can add significant cost.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
* Using *short codes*special telephone numbers designed for high traffic. This can add significant cost.
* Using *short codes*special telephone numbers designed for high traffic. This can add significant cost.

Writing style is em dash


* [Twilio Verify](https://www.twilio.com/docs/verify/api)

## What Next?
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
## What Next?
## What's next?

I still recommend working in keywords though... But headers are sentence case per the writing guidelines.


Moving to a service provider minimizes the technical requirements, though there's still vendor management and monitoring.

## Designing a DIY Hook
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
## Designing a DIY Hook
## Designing a DIY hook

deepu105 pushed a commit that referenced this pull request Aug 29, 2024
* add Maurice as author

* telephony post

* oops

* cleanup + add cta

* fix quotes

* Update _source/_posts/2024-08-15-otp-over-sms.md

Co-authored-by: Semona Igama <[email protected]>

* Update _source/_posts/2024-08-15-otp-over-sms.md

Co-authored-by: Semona Igama <[email protected]>

---------

Co-authored-by: Semona Igama <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants