Skip to content
Permalink

Comparing changes

Choose two branches to see what’s changed or to start a new pull request. If you need to, you can also or learn more about diff comparisons.

Open a pull request

Create a new pull request by comparing changes across two branches. If you need to, you can also . Learn more about diff comparisons here.
base repository: microsoft/TinyBlazorAdmin
Failed to load repositories. Confirm that selected base ref is valid, then try again.
Loading
base: v3.0
Choose a base ref
...
head repository: microsoft/TinyBlazorAdmin
Failed to load repositories. Confirm that selected head ref is valid, then try again.
Loading
compare: main
Choose a head ref
  • 15 commits
  • 22 files changed
  • 7 contributors

Commits on Nov 25, 2022

  1. Copy the full SHA
    5025b58 View commit details
  2. Copy the full SHA
    f976e1c View commit details
  3. Copy the full SHA
    3ace8cf View commit details
  4. Copy the full SHA
    48b9c0b View commit details

Commits on Dec 8, 2022

  1. Copy the full SHA
    038fc7d View commit details
  2. Copy the full SHA
    2658123 View commit details

Commits on Dec 9, 2022

  1. Copy the full SHA
    fec47f4 View commit details
  2. Copy the full SHA
    839e36b View commit details
  3. Merge pull request #95 from FBoucher/all-contributors/add-fatpacket

    docs: add fatpacket as a contributor for doc
    FBoucher authored Dec 9, 2022
    Copy the full SHA
    63c0e7f View commit details

Commits on Feb 10, 2023

  1. update repo urls

    pjirsa authored Feb 10, 2023
    Copy the full SHA
    2dd7205 View commit details
  2. Merge pull request #104 from microsoft/org-migration

    update repo urls
    ch-rob authored Feb 10, 2023
    Copy the full SHA
    ebcfc77 View commit details

Commits on Feb 15, 2023

  1. Copy the full SHA
    21a1e38 View commit details

Commits on Feb 16, 2023

  1. Merge pull request #106 from microsoft/CombineRepositories

    Repository Combining: Add documentation updates
    ch-rob authored Feb 16, 2023
    Copy the full SHA
    b13a787 View commit details

Commits on Jun 2, 2023

  1. Copy the full SHA
    b3657d5 View commit details

Commits on Jun 12, 2023

  1. Auto merge mandatory file pr

    This pr is auto merged as it contains a mandatory file and is opened for more than 10 days.
    Copy the full SHA
    b416001 View commit details
12 changes: 11 additions & 1 deletion .all-contributorsrc
Original file line number Diff line number Diff line change
@@ -54,12 +54,22 @@
"code",
"review"
]
},
{
"login": "fatpacket",
"name": "fatpacket",
"avatar_url": "https://avatars.githubusercontent.com/u/5621063?v=4",
"profile": "https://github.com/fatpacket",
"contributions": [
"doc"
]
}
],
"contributorsPerLine": 7,
"projectName": "TinyBlazorAdmin",
"projectOwner": "FBoucher",
"repoType": "github",
"repoHost": "https://github.com",
"skipCi": true
"skipCi": true,
"commitConvention": "angular"
}
12 changes: 0 additions & 12 deletions .github/FUNDING.yml

This file was deleted.

45 changes: 0 additions & 45 deletions .github/workflows/azure-static-web-apps-icy-coast-0871ee210.yml

This file was deleted.

45 changes: 0 additions & 45 deletions .github/workflows/azure-static-web-apps-lemon-forest-06c374b0f.yml

This file was deleted.

59 changes: 4 additions & 55 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,60 +1,9 @@
# TinyBlazorAdmin
<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
[![All Contributors](https://img.shields.io/badge/all_contributors-5-orange.svg?style=flat-square)](#contributors-)
[![All Contributors](https://img.shields.io/badge/all_contributors-6-orange.svg?style=flat-square)](#contributors-)
<!-- ALL-CONTRIBUTORS-BADGE:END -->

Admin tools for [Azure Url Shortener](https://github.com/FBoucher/AzUrlShortener) using [Blazor Single Page Application (webassembly)](https://azure.microsoft.com/services/app-service/static/?WT.mc_id=dotnet-0000-frbouche).
# Depricated
This repo has been deprecated, its content was combined into [AzUrlShortener](https://github.com/microsoft/AzUrlShortener). All further updates will be done to the code base in that repository.

The project is now at version 3 and ready to be used! It is using Azure Static Web App native security and the API is an Azure Function.

![Tiny Blazor Admin home page][tinyBA_home]

Once authenticated you can manage your URLs and see some statistics. Thanks to [Syncfusion](https://www.syncfusion.com/blazor-components) for the community licences. Everyone can use Tiny Blazor Admin with that great look!

![Tiny Blazor Admin URLs manager page][inyBA_urls]

![Tiny Blazor Admin Statistics page][inyBA_stats]



# Deployment

Until an automatic deployment is created, you will need to deploy some part manually. [All the steps to deploy the TinyBlazorAdmin app into Azure are listed here](deployment.md). You can also run it somewhere else if you prefer, even locally.



# Contributing

If you find a bug or would like to add a feature, check out those resources:

To see the current work in progress: [GLO boards](https://app.gitkraken.com/glo/board/XtpDU2ZLuQARV8y7) 'kanban board'


[TinyBlazorAdmin]: medias/TinyBlazorAdmin.png
[tinyBA_home]: medias/tinyBA_home.png
[inyBA_stats]: medias/inyBA_stats.png
[inyBA_urls]: medias/inyBA_urls.png

## Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->
<table>
<tr>
<td align="center"><a href="http://cloud5mins.com"><img src="https://avatars3.githubusercontent.com/u/2404846?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Frank Boucher</b></sub></a><br /><a href="https://github.com/FBoucher/TinyBlazorAdmin/commits?author=FBoucher" title="Documentation">📖</a> <a href="https://github.com/FBoucher/TinyBlazorAdmin/commits?author=FBoucher" title="Code">💻</a> <a href="#ideas-FBoucher" title="Ideas, Planning, & Feedback">🤔</a></td>
<td align="center"><a href="http://www.mayoclinic.org"><img src="https://avatars3.githubusercontent.com/u/765798?v=4?s=100" width="100px;" alt=""/><br /><sub><b>jbrule</b></sub></a><br /><a href="https://github.com/FBoucher/TinyBlazorAdmin/commits?author=jbrule" title="Documentation">📖</a></td>
<td align="center"><a href="https://cmatskas.com"><img src="https://avatars3.githubusercontent.com/u/4126750?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Christos Matskas</b></sub></a><br /><a href="#security-cmatskas" title="Security">🛡️</a> <a href="https://github.com/FBoucher/TinyBlazorAdmin/issues?q=author%3Acmatskas" title="Bug reports">🐛</a></td>
<td align="center"><a href="https://github.com/ronhowe"><img src="https://avatars1.githubusercontent.com/u/5210043?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Ron Howe</b></sub></a><br /><a href="https://github.com/FBoucher/TinyBlazorAdmin/commits?author=ronhowe" title="Documentation">📖</a></td>
<td align="center"><a href="https://github.com/Mark-Phillipson"><img src="https://avatars0.githubusercontent.com/u/16239024?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Mark Phillipson</b></sub></a><br /><a href="https://github.com/FBoucher/TinyBlazorAdmin/commits?author=Mark-Phillipson" title="Documentation">📖</a> <a href="https://github.com/FBoucher/TinyBlazorAdmin/commits?author=Mark-Phillipson" title="Code">💻</a> <a href="https://github.com/FBoucher/TinyBlazorAdmin/pulls?q=is%3Apr+reviewed-by%3AMark-Phillipson" title="Reviewed Pull Requests">👀</a></td>
</tr>
</table>

<!-- markdownlint-restore -->
<!-- prettier-ignore-end -->

<!-- ALL-CONTRIBUTORS-LIST:END -->

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
Read the [previous README.md](https://github.com/microsoft/TinyBlazorAdmin/blob/main/oldREADME.md)
41 changes: 41 additions & 0 deletions SECURITY.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
<!-- BEGIN MICROSOFT SECURITY.MD V0.0.8 BLOCK -->

## Security

Microsoft takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations, which include [Microsoft](https://github.com/microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), [Xamarin](https://github.com/xamarin), and [our GitHub organizations](https://opensource.microsoft.com/).

If you believe you have found a security vulnerability in any Microsoft-owned repository that meets [Microsoft's definition of a security vulnerability](https://aka.ms/opensource/security/definition), please report it to us as described below.

## Reporting Security Issues

**Please do not report security vulnerabilities through public GitHub issues.**

Instead, please report them to the Microsoft Security Response Center (MSRC) at [https://msrc.microsoft.com/create-report](https://aka.ms/opensource/security/create-report).

If you prefer to submit without logging in, send email to [secure@microsoft.com](mailto:secure@microsoft.com). If possible, encrypt your message with our PGP key; please download it from the [Microsoft Security Response Center PGP Key page](https://aka.ms/opensource/security/pgpkey).

You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Additional information can be found at [microsoft.com/msrc](https://aka.ms/opensource/security/msrc).

Please include the requested information listed below (as much as you can provide) to help us better understand the nature and scope of the possible issue:

* Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.)
* Full paths of source file(s) related to the manifestation of the issue
* The location of the affected source code (tag/branch/commit or direct URL)
* Any special configuration required to reproduce the issue
* Step-by-step instructions to reproduce the issue
* Proof-of-concept or exploit code (if possible)
* Impact of the issue, including how an attacker might exploit the issue

This information will help us triage your report more quickly.

If you are reporting for a bug bounty, more complete reports can contribute to a higher bounty award. Please visit our [Microsoft Bug Bounty Program](https://aka.ms/opensource/security/bounty) page for more details about our active programs.

## Preferred Languages

We prefer all communications to be in English.

## Policy

Microsoft follows the principle of [Coordinated Vulnerability Disclosure](https://aka.ms/opensource/security/cvd).

<!-- END MICROSOFT SECURITY.MD BLOCK -->
78 changes: 1 addition & 77 deletions deployment.md
Original file line number Diff line number Diff line change
@@ -1,79 +1,3 @@
# Deployment

## First thing first

### 👉 **Copy this repository** into your own account

> To Copy a GitHub repository click on the use this template button on the top right of the screen.
![Click on the button Use this template][CreateACopy]

Provide a name. It can be anything, it just need to be unique in your account (you can keep TinyBlazorAdmin if you want). Add a description it you want, and click the button **Create repository from template**.

![Give it a name description and click Create][NameYourCopy]

After a few seconds, you should now be in your version of the TinyBlazorAdmin project. If you need more detail have a look to this GitHub doc: [Fork a repo](https://docs.github.com/en/free-pro-team@latest/github/getting-started-with-github/fork-a-repo).

> Make sure you are currently in YOUR GitHub repository.
>
>![This should be YOUR repo][NotFBoucherRepo]

## Deploy AzUrlShortener (the Backend)

This project is a frontend for [Azure Url Shortener](https://github.com/FBoucher/AzUrlShortener). If it's not already done you will need to deploy this project in your Azure subscription.

## Deploy TinyBlazorAdmin

There are many ways you could run Tiny Blazor Admin website. In this deployment, we will use the new [Azure Static Web App (SWA)](https://azure.microsoft.com/en-ca/services/app-service/static/?WT.mc_id=tinyblazoradmin-github-frbouche).

Open Azure portal (portal.azure.com), open the **resource group** where you created the backend (ex: streamDemo is our case). Click the "**+**" and search **Static Web App**, and click the *Create* button.

![Creating swa][swa_create1]

> Note: You will need to **Authorize Azure Static Web Apps**, to have access to _your_ GitHub repository (the one created when you forked the project). This is required because SWA uses GitHub Action to deploy.
![Creating swa part 2][swa_create2]

Select your organization, repository and branch (ex: main).

![Creating swa part 3][swa_create3]

Select **Blazor** as your *Build Presets*. The *App location* needs to be the location of the project file; in our case `src/admin`. The Api is in the `src/api`. The *App artifact location* can be left to wwwroot.

Once it's all filled, click the Review, and create button. It will takes a few minutes to get deployed. During this time let's create and configure our security components.

## Create Invite to add users to the Admin role

Users need to be part of the of the role **admin** (all lowercase). To add them you need to use the *Role management* interface from in the Azure portal.

From the [portal](https://portal.azure.com/), open your static web app and select the *Role management* from the left options list. From there click the Invive button make sure you type **admin** all lowercase without extra spaces in the Role field.

![Create invire][create_invire]

This will create an invite that you can share with the recipient. Once the invite is accepted, the name should be visible in the list.

## Connect the Data

Let's add the connection to the Azure Storage table. In your AzUrlShortener resource group us look for the Azure storage starting by "urldata" and grab the connectionstring.

![get connectionstring][grab_connstring]

Now that we have the connectionstring, add it the configuration of the Azure static web App under the name `UlsDataStorage`.

![add_config][add_config]

## Try it!

Voila, the deployment is now completed. You can test it by creating a new short URL using the admin SWA.

[swa_create1]: medias/swa_create1.png
[swa_create2]: medias/swa_create2.png
[swa_create3]: medias/swa_create3.png
[swa_URL]: medias/swa_URL.png
[create_invire]: medias/create_invite.png
[add_config]: medias/add_config.png
[grab_connstring]: medias/grab_connstring.png
[NotFBoucherRepo]: medias/NotFBoucherRepo.png
[CreateACopy]: medias/CreateACopy.png
[NameYourCopy]: medias/NameYourCopy.png
⚠️ [Documentation moved to the WIKI](https://github.com/microsoft/TinyBlazorAdmin/wiki/Deployment) 👈
Binary file removed medias/CreateACopy.png
Binary file not shown.
Binary file removed medias/NameYourCopy.png
Binary file not shown.
Binary file removed medias/NotFBoucherRepo.png
Binary file not shown.
Binary file removed medias/RegisterClientApp.png
Binary file not shown.
Binary file removed medias/add_config.png
Binary file not shown.
Binary file removed medias/create_invite.png
Binary file not shown.
Binary file removed medias/grab_connstring.png
Binary file not shown.
Binary file removed medias/swa_URL.png
Binary file not shown.
Binary file removed medias/swa_create1.png
Binary file not shown.
Binary file removed medias/swa_create2.png
Binary file not shown.
Binary file removed medias/swa_create3.png
Binary file not shown.
Loading