From fd01a374aa143a6672d96ccaa76f66e194c15ef7 Mon Sep 17 00:00:00 2001 From: Dan Moore Date: Tue, 8 Aug 2023 14:43:44 -0400 Subject: [PATCH] Mooreds/migrating blog 3 (#2420) merging in more posts --- astro/package-lock.json | 17 ++++++++++ astro/package.json | 1 + .../login-theme-feature}/login-theme.png | Bin .../blogs/macos-install}/macos-install.jpg | Bin .../setup-complete-dashboard.png | Bin .../setup-wizard}/setup-create-api-key.png | Bin .../setup-create-application.png | Bin .../setup-smtp-server-config.png | Bin .../setup-wizard-create-admin.png | Bin .../identity-providers-screen.png | Bin .../social-login-signin-screen.png | Bin .../spring-and-fusionauth-example.jpg | Bin .../blog/download-install-mac-tutorial.mdx | 12 +++---- ...y-integration-of-fusionauth-and-spring.mdx | 31 +++++++++--------- .../content/blog/new-feature-login-theme.mdx | 17 ++++++---- ...e-social-login-facebook-google-twitter.mdx | 14 ++++---- .../content/blog/using-the-setup-wizard.mdx | 24 +++++++------- 17 files changed, 68 insertions(+), 48 deletions(-) rename {site/assets/img/blogs => astro/public/img/blogs/login-theme-feature}/login-theme.png (100%) rename {site/assets/img/blogs => astro/public/img/blogs/macos-install}/macos-install.jpg (100%) rename {site/assets/img/blogs => astro/public/img/blogs/setup-wizard}/setup-complete-dashboard.png (100%) rename {site/assets/img/blogs => astro/public/img/blogs/setup-wizard}/setup-create-api-key.png (100%) rename {site/assets/img/blogs => astro/public/img/blogs/setup-wizard}/setup-create-application.png (100%) rename {site/assets/img/blogs => astro/public/img/blogs/setup-wizard}/setup-smtp-server-config.png (100%) rename {site/assets/img/blogs => astro/public/img/blogs/setup-wizard}/setup-wizard-create-admin.png (100%) rename {site/assets/img/blogs => astro/public/img/blogs/social-login-signin-screen}/identity-providers-screen.png (100%) rename {site/assets/img/blogs => astro/public/img/blogs/social-login-signin-screen}/social-login-signin-screen.png (100%) rename {site/assets/img/blogs => astro/public/img/blogs/spring-fusionauth}/spring-and-fusionauth-example.jpg (100%) rename site/_posts/2019-02-07-download-install-mac-tutorial.md => astro/src/content/blog/download-install-mac-tutorial.mdx (97%) rename site/_posts/2018-10-24-easy-integration-of-fusionauth-and-spring.md => astro/src/content/blog/easy-integration-of-fusionauth-and-spring.mdx (96%) rename site/_posts/2018-11-12-new-feature-login-theme.md => astro/src/content/blog/new-feature-login-theme.mdx (79%) rename site/_posts/2018-11-14-new-feature-social-login-facebook-google-twitter.md => astro/src/content/blog/new-feature-social-login-facebook-google-twitter.mdx (83%) rename site/_posts/2019-02-05-using-the-setup-wizard.md => astro/src/content/blog/using-the-setup-wizard.mdx (87%) diff --git a/astro/package-lock.json b/astro/package-lock.json index d4aaf8f95b..ffbfd5a3ba 100644 --- a/astro/package-lock.json +++ b/astro/package-lock.json @@ -8,6 +8,7 @@ "name": "fusionauth-site", "version": "0.0.1", "dependencies": { + "@astro-community/astro-embed-youtube": "^0.4.0", "@astrojs/mdx": "^0.18.2", "@astrojs/sitemap": "^1.2.1", "@astrojs/tailwind": "^3.0.1", @@ -193,6 +194,17 @@ "node": ">=6.0.0" } }, + "node_modules/@astro-community/astro-embed-youtube": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/@astro-community/astro-embed-youtube/-/astro-embed-youtube-0.4.0.tgz", + "integrity": "sha512-rUEuZD5FTLaRaZFfmQO1JkywDNqZ8AqniG8qnSxNIj9qMS0wqSG/zcDkWpYlyOW3EL07aOBnDfaZSr3wwCy4wA==", + "dependencies": { + "lite-youtube-embed": "^0.2.0" + }, + "peerDependencies": { + "astro": "^2.0.0" + } + }, "node_modules/@astrojs/compiler": { "version": "1.3.0", "resolved": "https://registry.npmjs.org/@astrojs/compiler/-/compiler-1.3.0.tgz", @@ -4366,6 +4378,11 @@ "node": ">=10" } }, + "node_modules/lite-youtube-embed": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/lite-youtube-embed/-/lite-youtube-embed-0.2.0.tgz", + "integrity": "sha512-XXXAk5sbvtjjwbie3XG+6HppgTm1HTGL/Uk9z9NkJH53o7puZLur434heHzAjkS60hZB3vT4ls25zl5rMiX4EA==" + }, "node_modules/load-yaml-file": { "version": "0.2.0", "resolved": "https://registry.npmjs.org/load-yaml-file/-/load-yaml-file-0.2.0.tgz", diff --git a/astro/package.json b/astro/package.json index 4165d6cbd9..eb4b4d534a 100644 --- a/astro/package.json +++ b/astro/package.json @@ -11,6 +11,7 @@ "astro": "astro" }, "dependencies": { + "@astro-community/astro-embed-youtube": "^0.4.0", "@astrojs/mdx": "^0.18.2", "@astrojs/sitemap": "^1.2.1", "@astrojs/tailwind": "^3.0.1", diff --git a/site/assets/img/blogs/login-theme.png b/astro/public/img/blogs/login-theme-feature/login-theme.png similarity index 100% rename from site/assets/img/blogs/login-theme.png rename to astro/public/img/blogs/login-theme-feature/login-theme.png diff --git a/site/assets/img/blogs/macos-install.jpg b/astro/public/img/blogs/macos-install/macos-install.jpg similarity index 100% rename from site/assets/img/blogs/macos-install.jpg rename to astro/public/img/blogs/macos-install/macos-install.jpg diff --git a/site/assets/img/blogs/setup-complete-dashboard.png b/astro/public/img/blogs/setup-wizard/setup-complete-dashboard.png similarity index 100% rename from site/assets/img/blogs/setup-complete-dashboard.png rename to astro/public/img/blogs/setup-wizard/setup-complete-dashboard.png diff --git a/site/assets/img/blogs/setup-create-api-key.png b/astro/public/img/blogs/setup-wizard/setup-create-api-key.png similarity index 100% rename from site/assets/img/blogs/setup-create-api-key.png rename to astro/public/img/blogs/setup-wizard/setup-create-api-key.png diff --git a/site/assets/img/blogs/setup-create-application.png b/astro/public/img/blogs/setup-wizard/setup-create-application.png similarity index 100% rename from site/assets/img/blogs/setup-create-application.png rename to astro/public/img/blogs/setup-wizard/setup-create-application.png diff --git a/site/assets/img/blogs/setup-smtp-server-config.png b/astro/public/img/blogs/setup-wizard/setup-smtp-server-config.png similarity index 100% rename from site/assets/img/blogs/setup-smtp-server-config.png rename to astro/public/img/blogs/setup-wizard/setup-smtp-server-config.png diff --git a/site/assets/img/blogs/setup-wizard-create-admin.png b/astro/public/img/blogs/setup-wizard/setup-wizard-create-admin.png similarity index 100% rename from site/assets/img/blogs/setup-wizard-create-admin.png rename to astro/public/img/blogs/setup-wizard/setup-wizard-create-admin.png diff --git a/site/assets/img/blogs/identity-providers-screen.png b/astro/public/img/blogs/social-login-signin-screen/identity-providers-screen.png similarity index 100% rename from site/assets/img/blogs/identity-providers-screen.png rename to astro/public/img/blogs/social-login-signin-screen/identity-providers-screen.png diff --git a/site/assets/img/blogs/social-login-signin-screen.png b/astro/public/img/blogs/social-login-signin-screen/social-login-signin-screen.png similarity index 100% rename from site/assets/img/blogs/social-login-signin-screen.png rename to astro/public/img/blogs/social-login-signin-screen/social-login-signin-screen.png diff --git a/site/assets/img/blogs/spring-and-fusionauth-example.jpg b/astro/public/img/blogs/spring-fusionauth/spring-and-fusionauth-example.jpg similarity index 100% rename from site/assets/img/blogs/spring-and-fusionauth-example.jpg rename to astro/public/img/blogs/spring-fusionauth/spring-and-fusionauth-example.jpg diff --git a/site/_posts/2019-02-07-download-install-mac-tutorial.md b/astro/src/content/blog/download-install-mac-tutorial.mdx similarity index 97% rename from site/_posts/2019-02-07-download-install-mac-tutorial.md rename to astro/src/content/blog/download-install-mac-tutorial.mdx index 724d42ab78..8e78939800 100644 --- a/site/_posts/2019-02-07-download-install-mac-tutorial.md +++ b/astro/src/content/blog/download-install-mac-tutorial.mdx @@ -1,17 +1,17 @@ --- -layout: blog-post +publish_date: 2019-02-07 title: Download and Install FusionAuth - macOS description: Download and install FusionAuth on macOS with these easy steps. -author: Brian Pontarelli -image: blogs/macos-install.jpg -category: tutorial +authors: Brian Pontarelli +image: /img/blogs/macos-install/macos-install.jpg +categories: tutorial tags: macos installation -excerpt_separator: "" +excerpt_separator: "{/* more */}" --- Designed to save developer time and effort, there are only a few simple steps to download and install FusionAuth in your test or production environment. The following tutorial will explain how to install FusionAuth on your Macbook and be up and running in just a few minutes. This is one aspect that makes FusionAuth unique. Most existing identity technologies have a complex hierarchy of realms, principals, and distinguished names that restricts where they can be installed and requires extensive configuration. FusionAuth will install and run on a wide variety of systems including: - +{/* more */} - Linux - all distributions (64-bit) - macOS 10.8 (Mountain Lion) or newer diff --git a/site/_posts/2018-10-24-easy-integration-of-fusionauth-and-spring.md b/astro/src/content/blog/easy-integration-of-fusionauth-and-spring.mdx similarity index 96% rename from site/_posts/2018-10-24-easy-integration-of-fusionauth-and-spring.md rename to astro/src/content/blog/easy-integration-of-fusionauth-and-spring.mdx index 784ae34790..75817197c2 100644 --- a/site/_posts/2018-10-24-easy-integration-of-fusionauth-and-spring.md +++ b/astro/src/content/blog/easy-integration-of-fusionauth-and-spring.mdx @@ -1,23 +1,23 @@ --- -layout: blog-post +publish_date: 2018-10-24 title: Easy Integration of Spring and FusionAuth -author: Tyler Scott +authors: Tyler Scott description: Making a Spring application with FusionAuth is easy, just follow these simple steps. -image: blogs/spring-and-fusionauth-example.jpg +image: /img/blogs/spring-fusionauth/spring-and-fusionauth-example.jpg tags: tutorial-java tutorial java spring -category: tutorial -excerpt_separator: "" +categories: tutorial +excerpt_separator: "{/* more */}" --- +import Aside from '/src/components/Aside.astro'; -Making a Spring application with FusionAuth is easy. Follow the steps below and in about an hour you'll have FusionAuth providing user login and authorization for your application. Or you can be up and running in just a few minutes by using our example app. - +Making a Spring application with FusionAuth is easy. Follow the steps below and in about an hour you'll have FusionAuth providing user login and authorization for your application. Or you can be up and running in just a few minutes by using our example app. -{% include _callout-important.liquid -content= - "This post is old and no longer works. If you'd like to use Spring and FusionAuth, see this [post on using Spring Boot and FusionAuth together](/blog/2023/01/03/spring-and-fusionauth)." -%} +{/* more */} + Don't want to read? [Jump to the example](https://github.com/FusionAuth/fusionauth-example-spring-security). @@ -406,12 +406,11 @@ http.addFilterAfter(new OAuth2ClientContextFilter(), AbstractPreAuthenticatedPro ## Conclusion -{% include _callout-important.liquid -content= - "This post is old and no longer works. If you'd like to use Spring and FusionAuth, see this [post on using Spring Boot and FusionAuth together](/blog/2023/01/03/spring-and-fusionauth)." -%} + -That's all it takes! When you get set up, send us a link to your site. We'd love to see how you integrated FusionAuth with your Spring application. If you have any questions or comments, let us know in the comments below or [contact us](/contact). +That's all it takes! When you get set up, send us a link to your site. We'd love to see how you integrated FusionAuth with your Spring application. If you have any questions or comments, let us know in the [forum](/community/forum). ## Addendum diff --git a/site/_posts/2018-11-12-new-feature-login-theme.md b/astro/src/content/blog/new-feature-login-theme.mdx similarity index 79% rename from site/_posts/2018-11-12-new-feature-login-theme.md rename to astro/src/content/blog/new-feature-login-theme.mdx index 826607e1f9..e639608163 100644 --- a/site/_posts/2018-11-12-new-feature-login-theme.md +++ b/astro/src/content/blog/new-feature-login-theme.mdx @@ -1,17 +1,19 @@ --- -layout: blog-post +publish_date: 2018-11-12 title: New Feature - Login Theme description: Login themes allow you to completely customize the look and feel of your login pages -author: Brian Pontarelli -image: blogs/login-theme.png -category: features +authors: Brian Pontarelli +image: /img/blogs/login-theme-feature/login-theme.png +categories: features tags: feature-themes themes -excerpt_separator: "" +excerpt_separator: "{/* more */}" --- +import { YouTube } from '@astro-community/astro-embed-youtube'; + We are excited to announce an awesome new feature for FusionAuth. We call it `Login Theme`. This feature allows you to customize the look and feel of your login pages. This includes the login page itself, but also all the pages needed to support login including forgot password, two-factor authentication, update password, and others. - +{/* more */} We put together a complete tutorial in our docs as well as a deep dive video. This video shows you step-by-step how to replicate [StackOverflow's login page](https://stackoverflow.com/users/login) in FusionAuth. @@ -19,7 +21,8 @@ Here's the location of the tutorial: [https://fusionauth.io/docs/v1/tech/themes/ And the YouTube video: -{% include _youtube-video.liquid youtubeid="_ro3jH5Xkgo" %} + +
Let us know what you think about this new feature, the tutorial and the video. Also, if you need assistance building your login theme, [reach out](/contact) and we can lend a hand. diff --git a/site/_posts/2018-11-14-new-feature-social-login-facebook-google-twitter.md b/astro/src/content/blog/new-feature-social-login-facebook-google-twitter.mdx similarity index 83% rename from site/_posts/2018-11-14-new-feature-social-login-facebook-google-twitter.md rename to astro/src/content/blog/new-feature-social-login-facebook-google-twitter.mdx index e1b495c6b0..25eb8ee07f 100644 --- a/site/_posts/2018-11-14-new-feature-social-login-facebook-google-twitter.md +++ b/astro/src/content/blog/new-feature-social-login-facebook-google-twitter.mdx @@ -1,19 +1,19 @@ --- -layout: blog-post +publish_date: 2018-11-14 title: New Feature - Social Login for Facebook, Google, Twitter & More description: It's easy to enable social logins like Facebook, Google, Twitter and OpenID Connect with FusionAuth. -author: Bryan Giese -image: blogs/identity-providers-screen.png -category: features +authors: Bryan Giese +image: /img/blogs/social-login-signin-screen/identity-providers-screen.png +categories: features tags: social-login google facebook twitter -excerpt_separator: "" +excerpt_separator: "{/* more */}" --- You need social? We got social. Our newest update to FusionAuth makes it simple to enable social logins like Facebook, Twitter, and Google for all your applications. You can also connect and configure any generic OpenID Connect-based identity providers with simple configuration steps. On successful registration, we call the provider API to retrieve and store user information so you have an up-to-date user record. - +{/* more */} -{% include _image.liquid src="/assets/img/blogs/social-login-signin-screen.png" alt="Social Login Screen" class="float-left img-thumbnail mr-md-4" style="max-width: 200px;" figure=false %} +![Social Login Screen](/img/blogs/social-login-signin-screen/social-login-signin-screen.png) To get set up, simply go to **Settings > Identity Providers** in your FusionAuth dashboard. Then tap **Add provider** to select which to enable and configure. It's that easy. Read [the documentation here](/docs/v1/tech/identity-providers/). diff --git a/site/_posts/2019-02-05-using-the-setup-wizard.md b/astro/src/content/blog/using-the-setup-wizard.mdx similarity index 87% rename from site/_posts/2019-02-05-using-the-setup-wizard.md rename to astro/src/content/blog/using-the-setup-wizard.mdx index 91a2315af7..17ab159710 100644 --- a/site/_posts/2019-02-05-using-the-setup-wizard.md +++ b/astro/src/content/blog/using-the-setup-wizard.mdx @@ -1,17 +1,17 @@ --- -layout: blog-post +publish_date: 2019-02-05 title: Using the FusionAuth Setup Wizard description: The FusionAuth Setup Wizard makes setting up FusionAuth a simple step-by-step process. -author: Brian Pontarelli -image: blogs/setup-wizard-create-admin.png -category: tutorial +authors: Brian Pontarelli +image: /img/blogs/setup-wizard/setup-wizard-create-admin.png +categories: tutorial tags: setup-wizard setup -excerpt_separator: "" +excerpt_separator: "{/* more */}" --- The FusionAuth Setup Wizard is designed to make setting up FusionAuth a simple process so you can get back to working on the core features of your application. The step-by-step process only takes a few minutes to prepare FusionAuth to integrate with your application. The basic steps are: - +{/* more */} - Creating the initial admin user - Creating an application @@ -20,7 +20,7 @@ The FusionAuth Setup Wizard is designed to make setting up FusionAuth a simple p Once these are complete, you are able to call the API and start managing users. -To use the FusionAuth Setup Wizard, you will need to access the FusionAuth backend. If FusionAuth is hosting your instance in our private cloud, the URL will been provided to you already. If you have installed FusionAuth on your own system, you will need to know the IP address or hostname where it has been installed. For example, to access FusionAuth on localhost, you would use the following URL `\http://localhost:9011`. +To use the FusionAuth Setup Wizard, you will need to access the FusionAuth backend. If FusionAuth is hosting your instance in our private cloud, the URL will been provided to you already. If you have installed FusionAuth on your own system, you will need to know the IP address or hostname where it has been installed. For example, to access FusionAuth on localhost, you would use the following URL `http://localhost:9011`. ## The FusionAuth Setup Wizard: Create an Admin User @@ -28,17 +28,17 @@ In order to complete the FusionAuth Setup Wizard, you will be prompted to create If you instead are being prompted by the FusionAuth Maintenance Mode, please complete that setup first and then return to this step. See the Maintenance Mode section in the [FusionAuth App Installation Guide](/docs/v1/tech/installation-guide/fusionauth-app). -{% include _image.liquid src="/assets/img/blogs/setup-wizard-create-admin.png" alt="Create Admin User" class="full" figure=false %} +![Create Admin User.](/img/blogs/setup-wizard/setup-wizard-create-admin.png) The fields that are required are marked with a red asterisk. Type in an email and password that will be used to log into the FusionAuth management interface. The password must be at least 8 characters in length to pass validation. Before you click the Submit button you must accept the FusionAuth license, do so by clicking on the toggle . You may optionally opt-in to receive FusionAuth technical announcements. Click submit to complete this form and you will be logged into FusionAuth and be shown the Dashboard which will contain the three remaining items to be configured. -{% include _image.liquid src="/assets/img/blogs/setup-complete-dashboard.png" alt="Complete Setup Dashboard" class="full" figure=false %} +![Complete Setup Dashboard.](/img/blogs/setup-wizard/setup-complete-dashboard.png) ## Add Application The next step is to add an application. Select the blue Setup button to begin your first application and proceed to the Add Application form. -{% include _image.liquid src="/assets/img/blogs/setup-create-application.png" alt="Add Application" class="full" figure=false %} +![Add Application.](/img/blogs/setup-wizard/setup-create-application.png) A FusionAuth Application represents an authenticated resource. Think of it as something that users will log into. Required fields are marked with a red asterisk. Start by giving your application a name in the name field. We suggest that in most cases you use the name of your application. Next, you will create roles to represent authority levels in your application. If you're integrating FusionAuth into an existing application, you probably already know what your roles are, such as "admin", "user", or "manager". To add additional roles, click on the Add Role button and enter the name of the role. A description is not required but can be used to let others know what the role represents. If you are not sure at this stage, it is easy to add and modify existing roles after the Application has been created. Click the blue save button when you have completed the form. @@ -48,7 +48,7 @@ To return the dashboard select Dashboard from the menu on the left. The next step is to add an API key so you may begin your integration and make authenticated API requests. Select the blue Add button in the Missing API Key box to continue to the Add API Key page. -{% include _image.liquid src="/assets/img/blogs/setup-create-api-key.png" alt="Add API Key" class="full" figure=false %} +![Add API Key.](/img/blogs/setup-wizard/setup-create-api-key.png) As before, required fields are marked with a red asterisk. You will notice that FusionAuth has already created a unique API Key and pre-filled the Key field. You may use this generated key, or you can change it to something else if you prefer. For more effective and robust security, API keys should be long and difficult to guess. If you are going to create your own API key, be thoughtful about what you choose–once an API has been created, the key value cannot be changed. Again, the description is optional but is helpful to document the purpose or intended use of this API key. @@ -60,7 +60,7 @@ To return the dashboard select Dashboard from the menu on the left. The final item to complete is the SMTP server configuration. This step is not required to use FusionAuth, but is recommended since without it FusionAuth will be unable to send email. This means features such as Setup Password and Forgot Password will not function. Click the blue Setup button in the Email Setting box and you will see the System Settings page. -{% include _image.liquid src="/assets/img/blogs/setup-smtp-server-config.png" alt="SMTP Configuration" class="full" figure=false %} +![SMTP Configuration.](/img/blogs/setup-wizard/setup-smtp-server-config.png) The Email tab should already be selected. Start by toggling the Email settings "Enabled" button and the SMTP server configuration will become visible. As always, required fields are marked with a red asterisk. Complete the form by entering the SMTP host, port and username and password credentials if required. Generally these details will be provided by your SMTP service provider or IT department. Click the blue save button when you have completed the form and select Dashboard from the menu on the left.