Osoitekonvertteri
Marko Kaittola, FUNET

Miksi osoitekonvertteri?

Postinkulun ehk{p{ suurin ongelma t{m{n p{iv{n FUNETissa on yhteys eri
X.400-verkkoihin. Ongelma ei ensisijaisesti n{yt{ olevan yhteyden
luotettavuudessa tai nopeudessa, vaan k{yt|n vaikeudessa.

Suurin vaikeus on osoitteiden konvertoimisessa. Tyypillisi{ kysymyksi{
on kaksi: "Mik{ on minun osoitteeni X.400-esitysmuoto?" ja "Miten
konvertoin saamani osoitteen X.400-muotoon?"

Osoitekonvertteri on ty|kalu, jolla n{m{ ongelmat voidaan ratkaista.
Useimmissa tapauksissa lienee helpointa k{ytt{{ sit{
interaktiivisesti, mutta sen k{ytt| on mahdollista my|s s{hk|postin
v{lityksell{.

Interaktiivinen k{ytt|

Kirjoittautumalla koneelle funet.fi k{ytt{j{tunnuksella convert
voidaan konvertteria k{ytt{{ interaktiivisesti.

Sis{{nkirjoittautumisen j{lkeen k{ytt{j{lle esitet{{n
englanninkielinen valikko, josta on valittavissa nelj{ toimintoa:

1) X.400-osoitteen konvertoiminen Internet-osoitteeksi 
2) Internet-osoitteen konvertoiminen X.400-osoitteeksi. 
3) opastus ja 
0) lopetus. 

Mik{li valitaan osoitteen konvertoiminen kysyt{{n k{ytt{j{lt{ haluttua
osoitetta, mink{ j{lkeen esitet{{n konvertoitu osoite ja palataan
valikkoon.

X.400-osoite on annettava k{ytt{en kauttaviivanotaatiota.

K{ytt| postin v{lityksell{

Konvertterin k{ytt| onnistuu my|s l{hett{m{ll{ postia osoitteeseen 

        convert@funet.fi

tai X.400-muodossa osoitteeseen 

        /S=convert/O=funet/ADMD=fumail/C=fi/

Konvertteri tunnistaa kolme komentoa, nimitt{in help, X.400: ja
Internet:, joiden tulee olla viestin rungossa rivin alussa. Komentojen
tunnistus ei tee eroa isojen ja pienten kirjainten v{lill{.
Virheellisi{ rivej{ ei k{sitell{ mill{{n lailla

Internet: -rivill{ annetaan Internet-osoite, joka konvertoidaan
X.400-osoitteeksi.

X.400: -rivill{ annetaan Internet-osoitteeksi konvertoitava
X.400-osoite.  Komennon help tulee olla rivill{ yksin{{n. Se palauttaa
l{hett{j{lle konvertterin k{ytt|ohjeen.

Esimerkki interaktiivisesta k{yt|st{

Interaktiivinen k{ytt| sujuu esimerkiksi t{h{n tapaan: (Tietokoneen
tulostama teksti on painettu courier -tekstityypill{, k{ytt{j{n
kirjoittamat komennot Times boldilla)

simpukka /home/moa 51>telnet funet.fi
Trying 130.230.1.1 ...
Connected to funet.fi.
Escape character is `^]'.

SunOS UNIX (etana)


login: convert

 Welcome to FUNET address converter
 ==================================

1 Convert X.400 address to Internet address
2 Convert Internet address to X.400 address
3 HELP

0 Exit

Your choise: 3
--------------------------------------------------------------

This service is intended for converting Internet addresses (RFC 822
addresses) to X.400 addresses (OR addresses) and vice versa.

Internet users can use this to get a X.400 address that they can use
e.g. in business cards. These addresses will be accepted by Elisa and
Mailnet as well.

Internet users can also use this to convert Elisa and Mailnet
addresses as well as international R&D X.400 network addresses into
Internet addresses that they can use. (Please note that internal Elisa
addresses are not accepted. You need to use real X.400 address.)

Elisa users are advised to use converter provided by Elisa. Mailnet
users should ask Mailnet for advice about what to do.

After choosing address type to convert you are prompted for address.
Internet address should be given in it's normal format (e.g.
hmj@cs.tut.fi).

X.400 address should be given in "slash format" (e.g.
/S=uusitalo/OU=CC/O=tut/ADMD=fumail/C=fi/). If some parts of address
are missing they are converted as if the user is from domain funet.fi.

Some local rewriting may be done. For example, Internet address "moa"
will become "/G=Marko/S=Kaittola/O=funet/ADMD=fumail/C=fi/".

You can also use mail based interface. Send mail to

        convert@funet.fi
        /S=convert/O=funet/ADMD=fumail/C=fi/

In the body of the message send a line with only one word, "help", at
it's begining.

----------------------------------------------------------------
1 Convert X.400 address to Internet address
2 Convert Internet address to X.400 address
3 HELP
0 Exit

Your choise: 1
X.400 address: 
/S=helpdesk/O=hpy/ADMD=elisa/C=fi/
Internet:
/S=helpdesk/O=hpy/@elisa.fi

--------------------------------------------------------------
1 Convert X.400 address to Internet address
2 Convert Internet address to X.400 address
3 HELP

0 Exit

Your choise: 2
Internet address:
grus@simpukka.funet.fi
X.400:
/S=grus/OU=simpukka/O=funet/ADMD=fumail/C=fi/

--------------------------------------------------------------
1 Convert X.400 address to Internet address
2 Convert Internet address to X.400 address
3 HELP

0 Exit

Your choise: 0
Connection closed by foreign host.
simpukka /home/moa 52>

K{ytt| postin v{lityksell{

Konvertterin k{ytt| postin v{lityksell{ onnistuu vaikkapa l{hett{m{ll{
seuraavanlainen viesti:

From: moa@simpukka.funet.fi
To: convert@funet.fi
Subject: Don't care

HELP
Internet: grus@simpukka.funet.fi
X.400: /S=helpdesk/O=hpy/ADMD=elisa/C=fi/

T{ll|in konvertteri tuottaa seuraavan vastauksen:

From: FUNET address converter <postmaster@funet.fi>
To: moa@simpukka.funet.fi
Subject: Automatic reply

This message is generated automatically by FUNET address converter.
In need of help, please send a message to <convert@funet.fi>, 

</S=convert/O=funet/ADMD=fumail/C=FI/>. In the body of the message
send a line containing only one word, "help".

The next part of this message is the output of processing of your
message. If that part is empty server couldn't find any keywords in
your message.

If you need more help you can ask <postmaster@funet.fi>, 
</S=convert/O=funet/ADMD=fumail/C=FI/>.

-------- OUTPUT STARTS -------------

Internet: grus@simpukka.funet.fi
X.400: /S=grus/OU=simpukka/O=funet/ADMD=fumail/C=fi/


X.400: /S=helpdesk/O=hpy/ADMD=elisa/C=fi/
Internet:/S=helpdesk/O=hpy/@elisa.fi

        HELP FILE FOR FUNET MAIL CONVERTER
        ==================================

FUNET address converter is a utility for converting addresses between
Internet and X.400.

Conversion between Internet addresses (RFC 822 addresses) and
X.400-addresses (OR names) is based on conversion tables according to
RFC 1327. These tables are internationally co- ordinated by Cosine MHS
project team. Unfortunately conversion used for Elisa and Mailnet
can't be based on these rules. However, if you are a FUNET user and
convert your Internet address using Cosine rules the address can be
used by Elisa and Mailnet users. Elisa and Mailnet addresses are
converted according to Cosine rules.

This server is a dummy program that recognises only three keywords,
namely "HELP" "X.400:" and "Internet:". These words must appear at the
beginning of a line in the body of the message. "Internet:" must be
followed by Internet address, "X.400:" followed by X.400 address. For
lines with no identified keyword no output will be generated.

For example:

From. user@cs.tut.fi
To: convert@funet.fi
Subject: Don't care

HELP
Internet: L.user@polaris.utu.fi
X.400: /S=helpdesk/O=hpy/ADMD=elisa/C=fi/

As can be seen, Internet address shall be given as usual. X.400
address shall be given in "slash notation".

Conversion is done relative to funet.fi, or
/O=funet/ADMD=fumail/C=fi/. For example "user" is treated as
"user@funet.fi" and "/S=helpdesk/ADMD=mailnet/" as
"/S=helpdesk/ADMD=mailnet/C=FI/".  Some conversions for local part can
be done (e.g. moa@funet.fi ->
/G=Marko/S=Kaittola/O=funet/ADMD=fumail/C=fi/.)

---------- OUTPUT ENDS -------------

Rajoituksia

Konvertterin toiminta perustuu Cosine MHS-projektin kansainv{lisesti
koordinoimiin konversiotauluihin. Valitettavasti Elisa ja Mailnet
eiv{t ole mukana t{ss{ yhteisty|ss{.

K{yt{nn|ss{ t{m{ merkitsee sit{, ett{ voit konvertoida saamasi Elisa-
tai Mailnet-osoitteen, mutta sen sijaan em. palvelujen k{ytt{j{t eiv{t
voi konvertoida saamaansa satunnaista Internet-osoitetta sellaiseen
muotoon, ett{ he voisivat vastata siihen. Hekin voivat kuitenkin
konvertoida suomalaisen Internet-osoitteen itselleen k{ytt|kelpoiseen
muotoon.

Konvertteri on toteutettu PP:n ckadr-ohjelmalla. Se suorittaa funet.fi
-koneelle paikallisten osoitteiden kohdalla paikalliselle osalle
jonkin verran uudelleenkirjoitusta.

Konvertterin kehittely on edelleen kesken. Toiminnallisuus pysynee
oleellisilta osiltaan ennallaan, mutta k{ytt|liittym{t ja
opastustekstit tullevat muuttumaan.

