연락처를 휴대폰과 동기화하는 방법은 무엇입니까? Go!에서 CardDAV 구현하기

당신이 소규모 조직이나 클럽의 관리를 돕고 모든 회원의 세부 정보(이름, 전화번호, 이메일...)를 저장하는 데이터베이스를 가지고 있다고 가정해 보겠습니다.
필요한 곳 ​​어디에서나 최신 정보에 액세스할 수 있다면 좋지 않을까요? CardDAV를 사용하면 가능합니다!

CardDAV는 연락처 관리를 위해 잘 지원되는 개방형 표준입니다. iOS 연락처 앱에 기본적으로 통합되어 있으며 Android에서 사용할 수 있는 다양한 앱이 있습니다.

서버측에서 CardDAV를 구현하는 것은 특이한 http 메소드(GET, POST 대신 PROPFIND, REPORT...)에 응답하는 http 서버입니다. 다행스럽게도 작업을 크게 단순화할 수 있는 Go 모듈이 있습니다: github.com/emersion/go-webdav. 이 라이브러리는 구현된 백엔드를 기대하며 인증 후 HTTP 요청을 처리해야 하는 표준 http.Handler를 제공합니다.

입증

흥미롭게도 라이브러리는 사용자 인증과 관련하여 어떠한 도움도 제공하지 않지만 Go 구성성 덕분에 이는 문제가 되지 않습니다.
CardDAV는 기본 인증 자격 증명을 사용합니다. 자격 증명이 확인되면 해당 자격 증명을 컨텍스트에 저장할 수 있습니다(나중에 유용함).

package main

import (
    "context"
    "net/http"

    "github.com/emersion/go-webdav/carddav"
)

type (
    ctxKey   struct{}
    ctxValue struct {
        username string
    }
)

func NewCardDAVHandler() http.Handler {
    actualHandler := carddav.Handler{
        Backend: &ownBackend{},
    }

    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        username, password, ok := r.BasicAuth()
        // check username and password: adjust the logic to your system (do NOT store passwords in plaintext)
        if !ok || username != "admin" || password != "s3cr3t" {
            // abort the request handling on failure
            w.Header().Add("WWW-Authenticate", `Basic realm="Please authenticate", charset="UTF-8"`)
            http.Error(w, "HTTP Basic auth is required", http.StatusUnauthorized)
            return
        }

        // user is authenticated: store this info in the context
        ctx := context.WithValue(r.Context(), ctxKey{}, ctxValue{username})
        // delegate the work to the CardDAV handle
        actualHandler.ServeHTTP(w, r.WithContext(ctx))
    })
}

CardDAV 인터페이스 구현

ownBackend 구조체는 매우 얇지는 않지만 관리가 가능한 Carddav.Backend 인터페이스를 구현해야 합니다.

CurrentUserPrincipal 및 AddressBookHomeSetPath는 URL(슬래시로 시작하고 끝나야 함)을 제공해야 합니다. 일반적으로 사용자 이름/연락처가 됩니다. 여기서는 컨텍스트에서 사용자 이름을 추출해야 합니다(사용 가능한 유일한 인수):

func currentUsername(ctx context.Context) (string, error) {
    if v, ok := ctx.Value(ctxKey{}).(ctxValue); ok {
        return v.username, nil
    }
    return "", errors.New("not authenticated")
}

type ownBackend struct{}

// must begin and end with a slash
func (b *ownBackend) CurrentUserPrincipal(ctx context.Context) (string, error) {
    username, err := currentUsername(ctx)
    return "/" + url.PathEscape(username) + "/", err
}

// must begin and end with a slash as well
func (b *ownBackend) AddressBookHomeSetPath(ctx context.Context) (string, error) {
    principal, err := b.CurrentUserPrincipal(ctx)
    return principal + "contacts/", err
}

그 후에 재미있는 일이 시작됩니다. AddressBook, GetAddressObject 및 ListAddressObjects 메소드를 구현해야 합니다.

AddressBook은 경로가 위의 AddressBookHomeSetPath로 시작하고 슬래시로 끝나야 하는 간단한 구조체를 반환합니다.

GetAddressObject 및 ListAddressObjects는 현재 경로를 확인한 후(현재 인증된 사용자가 해당 연락처에 액세스할 수 있는지 확인하기 위해) 연락처를 AddressObject로 반환해야 합니다.

주소객체

AddressObject에는 여러 속성이 있으며, 가장 중요한 것은 다음과 같습니다.

• 이 특정 연락처를 식별하는 경로(임의일 수 있으며 슬래시로 시작)
• 클라이언트가 업데이트가 발생했는지 빠르게 확인할 수 있도록 하는 ETag(잊어버리면 iOS에 아무것도 표시되지 않음)
• VCard를 기대하는 카드

VCard는 실제 연락처 데이터를 나타내며 연락처 저장 방법에 따라 조정될 수 있습니다. 제 경우는 이렇게 끝났습니다.

func utf8Field(v string) *vcard.Field {
    return &vcard.Field{
        Value: v,
        Params: vcard.Params{
            "CHARSET": []string{"UTF-8"},
        },
    }
}

func vcardFromUser(u graphqlient.User) vcard.Card {
    c := vcard.Card{}

    c.Set(vcard.FieldFormattedName, utf8Field(u.Firstname+" "+u.Lastname))
    c.SetName(&vcard.Name{
        Field:      utf8Field(""),
        FamilyName: u.Lastname,
        GivenName:  u.Firstname,
    })
    c.SetRevision(u.UpdatedAt)
    c.SetValue(vcard.FieldUID, u.Extid)

    c.Set(vcard.FieldOrganization, utf8Field(u.Unit))

    // addFields sorts the key to ensure a stable order
    addFields := func(fieldName string, values map[string]string) {
        for _, k := range slices.Sorted(maps.Keys(values)) {
            v := values[k]
            c.Add(fieldName, &vcard.Field{
                Value: v,
                Params: vcard.Params{
                    vcard.ParamType: []string{k + ";CHARSET=UTF-8"}, // hacky but prevent maps ordering issues
                    // "CHARSET":       []string{"UTF-8"},
                },
            })
        }
    }

    addFields(vcard.FieldEmail, u.Emails)
    addFields(vcard.FieldTelephone, u.Phones)

    vcard.ToV4(c)
    return c
}

읽기 전용 단축키 사용

일부 방법을 사용하면 연락처를 업데이트할 수 있습니다. 내 회원 목록이 CardDAV를 통해 업데이트되는 것을 원하지 않기 때문에 Put 및 Delete 메서드에 403 오류를 반환합니다. return webdav.NewHTTPError(http.StatusForbidden, 오류.New("carddav: 작업이 지원되지 않음"))

로컬에서 테스트

iOS에서는 https를 통해 서비스를 제공하기 위해 CardDAV 서버가 필요합니다. openssl(192.168.XXX.XXX를 IP 주소로 대체)을 사용하여 로컬에서 자체 서명된 인증서를 생성하여 http.ListenAndServeTLS(addr, "localhost.crt", "localhost.key", NewCardDAVHandler())에 공급할 수 있습니다

openssl req -new -subj "/C=US/ST=Utah/CN=192.168.XXX.XXX" -newkey rsa:2048 -nodes -keyout localhost.key -out localhost.csr
openssl x509 -req -days 365 -in localhost.csr -signkey localhost.key -out localhost.crt

그런 다음 자신의 IP 주소와 포트를 가리키는 "CardDAV 연락처 계정"을 추가하여 로컬에서 실험할 수 있습니다.

결론

Go에서 CardDAV 서버를 구현하는 것은 약간 복잡하지만 그만한 가치가 있습니다. 연락처가 조직 서버에 있는 데이터와 자동으로 동기화됩니다!

이런 종류의 기본 통합을 허용하는 다른 멋진 프로토콜을 알고 계십니까? 여러분의 경험을 자유롭게 공유해 주세요!

위 내용은 연락처를 휴대폰과 동기화하는 방법은 무엇입니까? Go!에서 CardDAV 구현하기의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!