Skip to content

Commit b59b955

Browse files
committed
Update README
1 parent 5985c6c commit b59b955

File tree

3 files changed

+39
-18
lines changed

3 files changed

+39
-18
lines changed

LICENSE

+7-5
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,13 @@
1-
Copyright (c) 2004-2013 Fabien Potencier
1+
MIT License
2+
3+
Copyright (c) 2020 Nassim Ben Ghmiss
24

35
Permission is hereby granted, free of charge, to any person obtaining a copy
46
of this software and associated documentation files (the "Software"), to deal
57
in the Software without restriction, including without limitation the rights
68
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
7-
copies of the Software, and to permit persons to whom the Software is furnished
8-
to do so, subject to the following conditions:
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
911

1012
The above copyright notice and this permission notice shall be included in all
1113
copies or substantial portions of the Software.
@@ -15,5 +17,5 @@ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
1517
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
1618
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
1719
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
18-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
19-
THE SOFTWARE.
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

README.md

+32-13
Original file line numberDiff line numberDiff line change
@@ -1,46 +1,53 @@
11
angular-symfony
22
===============
33

4-
Project Bootstrap for an angularJS + Symfony webservices project.
4+
Project Bootstrap for an Angular 2+ and Symfony 4+ webservices project.
55

66
Introduction
77
------------
88

9-
This project is a template application with secured communication via a RestFul API between the client part with AngularJS and the server part with Symfony2.
9+
This project is a template application with a secured RestFul API communication via WSS UserToken security scheme.
10+
11+
Buy me a coffee
12+
---------------
13+
14+
[![Buy me a coffee](https://raw.githubusercontent.com/FlyersWeb/angular-symfony/upgrade/buy-me-a-coffee.png)](https://paypal.me/nac1dbois)
15+
16+
I'm working on this project in my free time and offering it free of charges. To help me work more on this you can help me by sending me a tip.
1017

1118
Installation
1219
------------
1320

14-
Install docker and docker-compose, refer to docker documentation.
21+
Install docker and docker-compose.
1522

1623
Clone the project :
1724

18-
git clone [email protected]:FlyersWeb/angular-symfony.git angular-symfony
25+
git clone [email protected]:FlyersWeb/angular-symfony.git
1926

2027
Launch dockerized environment :
2128

22-
docker-compose up -d
29+
docker-compose up -d
2330

2431
Log in application docker image :
2532

26-
docker-compose exec application bash
33+
docker-compose exec application bash
2734

2835
Update schemas (FOSUserBundle) :
2936

30-
php bin/console doctrine:schema:create
37+
php bin/console doctrine:schema:create
3138

3239
Create and activate user :
3340

34-
php bin/console doctrine:fixtures:load
41+
php bin/console doctrine:fixtures:load
3542

3643
Access the front end using port 4200 :
3744

38-
firefox http://localhost:4200 &
45+
firefox http://localhost:4200 &
3946

4047
Authentication system
4148
---------------------
4249

43-
The Authentication system is based on the custom Authentication Provider of the Symfony2 Cookbook : http://symfony.com/doc/2.1/cookbook/security/custom_authentication_provider.html
50+
The Authentication system is based on the custom Authentication Provider of the [Symfony Cookbook](https://symfony.com/doc/4.4/security/custom_authentication_provider.html)
4451

4552
> The following chapter demonstrates how to create a custom authentication provider for WSSE authentication. The security protocol for WSSE provides several security benefits:
4653
> * Username / Password encryption
@@ -49,14 +56,26 @@ The Authentication system is based on the custom Authentication Provider of the
4956
>
5057
> WSSE is very useful for the securing of web services, may they be SOAP or REST.
5158
52-
I used the exact same authentication system with a little change in moment of generating the digest, we use the hexadecimal value of the hashed seed in lieu of the binary value.
59+
I used the exact same authentication system.
5360

5461
Client Side specifics
5562
---------------------
5663

57-
On the client side, I've inspired my code from Nils Blum-Oeste article explaining how to send an authorization token for every request. To do this you have to register a wrapper for every resource actions that execute a specific code before doing the action. For more information you can check http://nils-blum-oeste.net/angularjs-send-auth-token-with-every--request/.
64+
On the client side, I've inspired my code from Angular official documentation about HttpInterceptor, allowing me to send the WSS UserToken on each HTTP request when token is available. Examples usually shows how to send the Authorization header.
65+
66+
The difference there is that I send the token, username and user digest in the HTTP Header *X-WSSE*.
67+
68+
LICENSE
69+
-------
70+
71+
This program is free software. It comes without any warranty, to the extent permitted by applicable law.
72+
73+
This software is LICENSED under the MIT License. Use it at your own risk.
74+
75+
WARNING
76+
-------
5877

59-
The differences there is that I send the token, username and user digest in the HTTP Header *X-WSSE*.
78+
Servers are configured for developments purposes. Do not deploy this project on production as is. You should have a look to [Symfony deployment documentation](https://symfony.com/doc/4.4/deployment.html) for the Back-end and the [Angular deployment documentation](https://angular.io/guide/deployment) for the Front-End part.
6079

6180
Conclusion
6281
----------

buy-me-a-coffee.png

5.17 KB
Loading

0 commit comments

Comments
 (0)