File: INSTALL

package info (click to toggle)
libweb-solid-auth-perl 0.91-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 360 kB
  • sloc: perl: 1,344; makefile: 5; sh: 1
file content (92 lines) | stat: -rw-r--r-- 1,606 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
# INSTALL

## libmagic library 

For mime type guessing we need the `libmagic` library.

On Debian/Ubuntu run:

```
sudo apt-get install libmagic-dev
```

On Red Hat run:

```
sudo yum install file-devel file-libs
```

On Mac you can use homebrew (https://brew.sh/):

```
brew install libmagic
```

See also: https://metacpan.org/pod/File::LibMagic

## CPANM

CPANM is the Perl package manager

On Debian/Ubuntu run:

```
sudo apt-get apt-get install cpanminus
```

On Red Hat run:

```
sudo  yum install perl-App-cpanminus 
```

On Mac you can use homebrew:

```
brew install cpanminus
```

## Install this package from the official release

Run

```
cpanm Web::Solid::Auth
```

Add your favorite Solid Pod to your `.bashrc` or `.zshrc` (depending on your shell)

```
# Your WebId
export SOLID_WEBID=https://hochstenbach.inrupt.net/profile/card#me
# The baseUrl used for relative urls (without the slash at the end!)
export SOLID_REMOTE_BASE=https://hochstenbach.inrupt.net
```

Reread your shell configuratation file:

```
source ~/.bashrc
```

## Hello World

Authenticate to your own pod. The program below will ask you to open a link
in a webbrowser and authenticate at your identity provider (IDP). When you
are authenticated you can close the program

```
solid_auth.pl authenticate
```

Now you can check private data

```
# List the root container
solid_auth.pl list /
```

## PLENV

If you happen to happen to run [plenv](https://github.com/tokuhirom/plenv) , a Perl binary manager, don't forget to run `plenv rehash` after you ran `cpanm`. This
will put the `solid_auth.pl` script in your path.