✍️ @Konny's Blog

[KonnyGuo]

Timeline:

• 📋 Dec 1st have an outline and open up issue
• 📰 Dec 8th have rough draft in
  • Mentor reviews by 12/15
• [ ] Dec 15th-20th turn in final draft

📋 Adding Authentication to Amplify with Passport.js

Requirements

Questions to consider:

• Who’s reading this? Where are they in your dev journey? What do they need to know before they can dive into this story? This post is mainly for developers with Node.js and Express experience who are looking to add authentication to an application. Some understanding with sessions, encryption and authentication concepts would help.

• If people could leave with just one action, what would it be? Implementing authentication is a crucial task for any application. Using Passport.js gives a balance of security, simplicity and scalability. The local strategy delivers secure password login flow, and allows the flexibility to extend authentication features for the future.

• Were there surprises or alternative problem solving you want to give a heads up to? There are many other Passport.js strategies that we could have implemented. But we chose the local strategy for its flexibility, simplicity and scalability for the future. An auth middleware file was also implemented to help redirect admins to the correct pages when they are logged in. If admins are not logged in, the middleware is used to redirect them to the login page to sign in so that certain pages can be accessed.

Outline Structure: Why is security important for any application and what do we consider when implementing it?

• Discuss the issue and solution
• Talk about different Passport.js strategies and why local strategy was chosen
• Talk about middleware and why it is used with security
• Mention issues that came with implementing the solutions

Example Outlines

What makes good documentation on open source?

• Could this be a list? (3 pieces of documentation thats easy to check for and add to the project to add immediate value?
• What inspired you from the Tech documentation workshop?
• What would you help encourage other first time contributors to do?
• Is a learning curve for everyone? And whats the balance between good documentation and too much documentation? Choice architecture
• What is each space used for? Wiki vs Discussion vs Pages
• How do we search and find? Reference: https://blackgirlbytes.dev/conquering-the-fear-of-contributing-to-open-source Reference issue/PR for photos Conclusion: Documentation is always changing, will always be needed`

To Do: when you complete the requirements, add "outline ready" label on your issue

• [ ] Identify your topic from one of the PRs approved
• [ ] Outlining bullet points of blog roadmap
• [ ] Is your blog a List, Survey, or demo?
• [ ] Which Visuals or Diagram or Code snippets will you add
• [ ] References to resources

📰 Blog Rough draft: Format into a google doc

Questions to answer across draft

• Why is this helpful for a reader?
• What problem does this help them solve?
• What kind of experience should the reader have or that you will provide so they’re up to speed
• What larger problem is this solving?
• Were there other ways of solving this problem - what made you choose the one that you did?
• What were the positive tradeoffs? (Did it save time? Save hours? Was more secure?)
• What is the best way to present the content (i.e. code snippets, graphics) ?
• What additional resources can they provide the reader if they want more information?
• Is there a call to action?

To do: when you complete the requirements, add "draft ready" label on your issue

• [ ] intro paragraph
• [ ] context of Amplify
• [ ] paragraph on problem
• [ ] paragrph compare your solution
• [ ] paragraph impact your solution
• [ ] Less than 600 words
• [ ] Drop link to your google doc (with permissions for edits) in review issue

[unnamedrd]

@KonnyGuo did you have a link to a blog?

[KonnyGuo]

@unnamedrd sorry about that, I forgot to attach my link. Here is the link to the blog: https://docs.google.com/document/d/14by2NcBWglWQ5qrbY-qMMb5iERDLEN6M1vbnK2IP6sE/edit?usp=sharing

[unnamedrd]

No problem Konny! Thanks for adding that.

[unnamedrd]

@KonnyGuo You're a talented writer! I do have some comments, and have requested write access to the doc.

[KonnyGuo]

@unnamedrd you should have access now. Let me know if it works for you.

[KonnyGuo]

@unnamedrd I made edits based on the comments you provided. Feel free to take a look over it and see if everything is all good. https://docs.google.com/document/d/14by2NcBWglWQ5qrbY-qMMb5iERDLEN6M1vbnK2IP6sE/edit?usp=sharing