malinux

malinux' lillablogg

bitlbee 3.2.2 på Debian Jessie — Denne posten er skrevet av malinux —

bitlbee på Debian Jessie


Vanskelighetsgrad
Grønn

Hva er bitlbee? Bitlbee er en portal for lynemdeldingstjenster til irc, som blant annet facebook-chat, skype, twitter, xmpp/jabber, gtalk, aim, icq og en rekke andre tjenster, slik at du kan chatte på facebook-chat, skype, etc, etc, rett i din irc-klient. Hvor mye som støttes av de forskjellige tjeneste varierer, og jeg har ikke prøvd ut alle selv.

I motsetning til bitlbee 3.2.2 i Debian Wheezy, så er installasjon av bitlbee 3.2.2 mye enklere i Debian Jessie, som ble lansert 25.04.2015, da Jessie har den nødvendige versjonen av bitlbee i pakkearkivet. Fremgangsmåten blir dermed mye enklere. Konfigurasjonen og oppsettet av facebook-chatten, er lik som for Wheezy. Denne posten er derfor lik den for Wheezy, med unntak av denne hovedseksjonen, som innebærer installasjon av selve bitlbee.

# apt-get install bitlbee bitlbee-dev

  • # - betyr at kommandoen kjøres som root

Pakken bitlbee-dev trengs for å kompilere facebook-chat-støtten og trengs ikke om du ikke ønsker facebookstøtten. I fremtiden en gang, blir den nok integrert i bitlbee, slik den gamle xmpp-facebook-chatten er pr. i dag.

Facebook-chat

Den ene måten er å installere fra utviklerens programvarearkiv.

Opprett følgende fil:

$ <dinteksteditor> /etc/apt/sources.list.d/jgeboski.list

Åpne filen og legg til følgende linje:

deb http://download.opensuse.org/repositories/home:/jgeboski/Debian_8.0 ./

Lagre og avslutt tekstprogrammet.

Legg til programvarearkiv nøkkelen, som godkjenner kilden for maskinen:

$ wget -O- https://jgeboski.github.io/obs.key | sudo apt-key add -

Oppdater programvareindeksen:

# apt-get update

# apt-get install bitlbee-facebook

Den andre måten er å kompilere fra kilden:

 

For å kompilere og installere facebook-chat-støtte, må gjøres etter at vi installerte deb-pakkene vi laget over. Dette programtillegget bruker facebook sin mobil-api.

# apt-get install dh-autoreconf checkinstall

$ cd ~/src/bitlbee
$ git clone https://github.com/jgeboski/bitlbee-facebook
$ cd bitlbee-facebook
$ ./autogen.sh
$ make
# checkinstall

    $ - betyr at kommandoen bør kjøres som vanlig bruker

Grunnen til at jeg her velger å bruke checkinstall og ikke dpkg-buildpackage, som med kildekoden til bitlbee, er at kildekoden til dette programtillegget, ikke er Debanisert. Det vil si at det mangler en Debian-mappe med filer som forteller hvordan og hvilke deb-pakker som skal generes, samt hvilke avhegigheter en pakke trenger for å installere. Dette kan man sette opp selv, men dette er for omfattende til å forklare her, samt at jeg selv pr. i dag mangler kunnskap om hvordan dette gjøres. Senere vil nok dette programtillegget uansett bli integrert i bitlbee, så man slipper å installere den eksternt.

Jeg bruker å svare ja på spørsmålet om å generere et standardsett med dokumentasjons-filer her. Jeg tror ikke det er veldig farlig å svare nei her da, pakken kun skal brukes lokalt, og ikke i en repo:

bitlbee-facebook-plugin-1-1

Skriv inn en beskrivelse av hva programmet gjør. Jeg la inn beskrivelsen fra de to første linjene i README-fila. Denne linja kan godt være tom også. Når man har skrevet inn, eller kopiert inn en beskrivelse, så trykker man på enter, så enter en gang til på en tom linje, og vips, så går den videre

bitlbee-facebook-plugin-1-3

I menyen som kommer opp nå, så kan man endre på beskrivelse av diverse egenskaper, etc, for deb-pakken vi nå skal lage. Vi ser f.eks. at beskrivelsen vi skrev inn i forrige steg, allerede står der. For å endre på noe, skriv inn tallet bak det du vil endre.
Det første som bør gjøres, så det ikke blir kluss med bitlbee-pakken vi har laget tidligere, er å endre navnet fra bitlbee til bitlbee-plugin-facebook. Trykk på 3, skriv inn bitlbee-plugin-facebook. Dette vil bli navnet på deb-pakken.

Vi må endre versjon fra facebook til et tall, da det ikke går å generere deb-pakker uten tall som versjonsnummer. Da jeg ikke vet hvilken versjon dette er av programtillegget, så har jeg bare skrevet 1 der.
Trykk på 3 og trykk enter, så skriv inn 1 og trykk enter.

bitlbee-facebook-plugin-1-2

Når vi nå er ferdige med å sette opp de nødvendige parameterne, trykker vi bare enter igjen, for å gå videre i prosessen.

 

Konfiguere bitlbee

For at bitlbee skal fungere slik vi ønsker, så trenger vi å konfiguere litt konfigurasjonsfiler.

# <tekst-editor> /etc/bitlbee/bitlbee.conf

Der kan være vi/vim, nano, eller hva du liker. er din editor vi, blir det slik:

# vi /etc/bitlbee/bitlbee.conf

I denne konfigurasjonsfila er det følgende verdier som må endres:

RunMode = ForkDaemon
User = bitlbee
DaemonInterface = 0.0.0.0
DaemonPort = 6667
AuthMode = Open
AuthPassword = md5:SECRET_HASH
OperPassword = md5:SECRET_HASH
ConfigDir = /etc/bitlbee

  • RunMode - Definerer hvordan vi vil at bitlbee skal kjøre. Mulige valg: Inetd, Daemon, ForkDaemon. ForkDeamon bør brukes, da hver klient får sin egen prosess. F.eks. facebook i en, og gtalk i en annen prosess.
  • User - Bruker. Brukeren vi vil at bitlbee skal kjøre som. Det er ikke lurt å sette brukeren til root f.eks..
  • DaemonInterface - Hvilke addresser bitlbee skal lytte til. Dvs. Alle.
    DaemonPort - Hvilken port bitlbee skal lytte til. 6667 gir mening, da det er innenfor portområdet til irc.
  • AuthMode - Denne må stå på Open til du har fått registrert en brukerkonto på serveren. Etter det er gjort, settes den til Registered, da er det bare registrerte brukere som får koblet til. Om venner skal ha konto på serveren, så kan den settes til Open fram til de har registrert seg, og så sette den til Registered igjen f.eks.
  • AuthPassword - Trengs for å logge inn på lukkede systemer. For å generere en hashtag, skriv:

# bitlbee -x hash .

kopier og erstatt SECRET_HASH med hashtaggen du fikk fra kommandoen over

  • OperPassword - Denne åpner opp for operatørkommandoer. Bruk samme kommando som over, for å genere en ny hastag og erstatt SECRET_HASH med hashtaggen.
  • ConfigDir - peker til mappen der konfigurasjonsfila til bitlbee ligger.

Så må vi legge til systembrukeren bitlbee, siden denne brukeren skal kjøre bitlbee-serveren.

# add-user --system bitlbee
# chown -R bitlbee:bitlbee /etc/bitlbee

Rediger filen /etc/default/bitlbee slik at paramteren BITLBEE_OPTS="-F" endres til BITLBEE_OPTS="-F -c /etc/bitlbee/bitlbee.conf på den måten defineres det hvor bitlbee skal hente konfigurasjonsfilen fra.

 

Start bitlbee-serveren

# service bitlbee start

Koble til bitlbee med din irc-klient

Her vil framgangsmåten være avhengig av hvilken irc-klient du bruker. Jeg bruker weechat. Dermed er eksemplene her basert på weechat.

For å koble weechat til bitlbee:

/server add bitlbee localhost/6667 -autoconnect
/connect bitlbee

weechat kobler seg til en kontrollkanal, som heter &bitlbee.

Først må vi registrere oss mot bitlbee-serveren

register <passord>

der <passord-, er et passord du ønsker å bruke med bitlbee-brukeren din. Ønsker du  å bruke passordet hemmelig, vil det bli sånn her:

register hemmelig

Da irc i seg selv ikke er kryptert, ikke bruk ditt systemroot-passord her.

Neste gang du logger deg inn, må du skrive identify for å få tilgang til kontoen din.

For å legge til f.eks. facebook-chaten:

account add facebook <brukernavn> <passord>

  • brukernavn - e-postadressen du bruker å logge inn på facebook med
  • passord - passordet du bruker å logge inn på facebook med.

account facebook on

For å få en oversikt over hvilke kontoer du har lagt til, skriv

account list

bitlbee-facebook-plugin-1-8

Som vi ser, så kan man også skrive ac list, der ac er fortkortelse for account, men begge gir en lignende output i irc-klienten.
For å prate til noen, pass på at du er i &bitlbee kontrollkanalen, og skriv

/msg <navn på den du vil chatte med> <melding>

Navnet må skrives likt, slik det fremstår, når du skriver /names og får en oversikt over brukere som er pålogget

F.eks. vil jeg prate med en som heter Fornavn Etternavn, så gjør man dette for å prate med vedkommene 🙂

/msg FornavnEtternavn hei

Det vil komme flere bitlbeeguider fremmover, men jeg stopper altså her foreløpig, da denne posten er blitt alt for lang 🙂

I fremtidige blogginnlegg om bitlbee, vil det komme mer informasjon om hvordan man kan bruke bitlbee, som hvordan man legger til andre protokoller, gruppechat, kanaler, automatisk innlogging, legge til/fjerne kontakter. Da jeg ikke bruker alle protokoller bitlbee støtter, så får jeg dessverre ikke laget guider for alle protokoller

Når jeg prater med en bruker på facebook, så ser det sånn ut i weechat:

bitlbee-facebook-plugin-1-7

 

Kilder


Categorised as: bitlbee | Debian | jessie


2 Comments

  1. Ørjan Hansson says:

    Takk for fantastisk "How to" 🙂

    • malinux says:

      Takk for at du liker den 🙂

      Det kommer flere poster om bitlbee etterhvert. Blant annet hvordan man kan tilpasse oppsettet litt mer til egen smak, etc, etc 🙂

Leave a Reply to malinux Cancel reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.